PopNowDocs da API
Conteúdo principal

Referência da API do Kling 2.1 Master

Clipes 1080p sem som, com controle fino pelo prompt

Com uma única chave de API da PopNow você chama o Kling 2.1 Master 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
Kuaishou
Resultado
Vídeo
A partir de
32.4 créditos por segundo gerado ($0.324)

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

kling/2.1-master/text-to-video

Preço

OpçãoCréditos (por segundo gerado)Dólares
Padrão32.4$0.324

Parâmetros

CampoTipoPadrãoValores aceitosPara que serve
promptObrigatóriostring—até 5.000 caracteresDescribe the scene, the action and the camera.
aspect_ratioOpcionalstring16:916:9, 9:16, 1:1Output aspect ratio.
duration_secondsOpcionalinteger55, 10Output length: 5 or 10 seconds. Billed per second.
negative_promptOpcionalstring—até 500 caracteresThings the clip should avoid, written as a short list.
guidance_scaleOpcionalnumber0.5de 0 a 1How strictly the clip follows the prompt, from 0 to 1. Higher is more literal, lower gives the model more freedom.

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": "kling/2.1-master/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
  }
}'

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

kling/2.1-master/image-to-video

Preço

OpçãoCréditos (por segundo gerado)Dólares
Padrão32.4$0.324

Parâmetros

CampoTipoPadrãoValores aceitosPara que serve
promptObrigatóriostring—até 5.000 caracteresDescribe what happens after the opening frame: the action, the camera.
image_urlObrigatóriostring (uri)——Opening frame. The clip starts from this image. JPEG or PNG only.
duration_secondsOpcionalinteger55, 10Output length: 5 or 10 seconds. Billed per second.
negative_promptOpcionalstring—até 500 caracteresThings the clip should avoid, written as a short list.
guidance_scaleOpcionalnumber0.5de 0 a 1How strictly the clip follows the prompt, from 0 to 1. Higher is more literal, lower gives the model more freedom.

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": "kling/2.1-master/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
  }
}'

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"

Próximos passos

Nesta página