Referência da API do HappyHorse 1.1

Com uma única chave de API da PopNow você chama o HappyHorse 1.1 direto do seu código. Aqui estão os IDs de modelo a enviar, cada campo de entrada aceito, quantos créditos custa cada requisição e um exemplo que você cola no terminal e roda.

As descrições dos parâmetros vêm do schema de entrada do modelo e estão disponíveis só em inglês.

Resumo

Desenvolvedor: Alibaba
Resultado: Vídeo
A partir de: 21 créditos por segundo gerado ($0.21)
IDs de modelo: alibaba/happyhorse-1.1/text-to-video
alibaba/happyhorse-1.1/image-to-video
alibaba/happyhorse-1.1/reference-to-video

1 crédito = US$ 0,01. Ao ser aceita, a tarefa reserva o valor máximo possível e, no fim, cobra o uso real, arredondado para cima em créditos inteiros; o restante é liberado. Tarefas que falham não são cobradas. Para saber o valor exato antes de rodar, chame POST /api/v1/jobs/quote.

Criar vídeo

alibaba/happyhorse-1.1/text-to-video

Preço

Opção	Créditos (por segundo gerado)	Dólares
`720p`	21	$0.21
`1080p`	27	$0.27

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 2.500 caracteres	Describe the scene, action, camera movement, and timing.
`aspect_ratio`Opcional	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Output aspect ratio.
`resolution`Opcional	`string`	`720p`	720p, 1080p	Output video resolution.
`duration_seconds`Opcional	`integer`	`5`	de 3 a 15	Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/happyhorse-1.1/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Imagem para vídeo

alibaba/happyhorse-1.1/image-to-video

Preço

Opção	Créditos (por segundo gerado)	Dólares
`720p`	21	$0.21
`1080p`	27	$0.27

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 2.500 caracteres	Describe the scene, action, camera movement, and timing.
`image_url`Obrigatório	`string (uri)`	—	—	Image used as the first video frame.
`resolution`Opcional	`string`	`720p`	720p, 1080p	Output video resolution.
`duration_seconds`Opcional	`integer`	`5`	de 3 a 15	Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.
`seed`Opcional	`integer`	—	de 0 a 2147483647	Random seed for controlled comparisons. Omit it to let each run pick its own.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

O exemplo usa arquivos de amostra da PopNow em image_url. Troque pelos seus próprios links HTTPS públicos, uploads ou assets salvos.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/happyhorse-1.1/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Referências para vídeo

alibaba/happyhorse-1.1/reference-to-video

Preço

Opção	Créditos (por segundo gerado)	Dólares
`720p`	21	$0.21
`1080p`	27	$0.27

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 2.500 caracteres	Describe the scene, action, camera movement, and timing.
`reference_image_urls`Obrigatório	`array<string (uri)>`	—	até 9 itens	Reference images in the order used by the prompt.
`aspect_ratio`Opcional	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	Output aspect ratio.
`resolution`Opcional	`string`	`720p`	720p, 1080p	Output video resolution.
`duration_seconds`Opcional	`integer`	`5`	de 3 a 15	Output duration in seconds. Any integer from 3 to 15 is accepted; longer clips cost proportionally more.
`seed`Opcional	`integer`	—	de 0 a 2147483647	Random seed for controlled comparisons. Omit it to let each run pick its own.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

O exemplo usa arquivos de amostra da PopNow em reference_image_urls. Troque pelos seus próprios links HTTPS públicos, uploads ou assets salvos.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/happyhorse-1.1/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Referência da API do HappyHorse 1.1

Resumo

Criar vídeo

Preço

Parâmetros

Exemplo de requisição

Imagem para vídeo

Preço

Parâmetros

Exemplo de requisição

Referências para vídeo

Preço

Parâmetros

Exemplo de requisição

Próximos passos

Nesta página