Referência da API do Kling 3.0

Com uma única chave de API da PopNow você chama o Kling 3.0 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: 10.08 créditos por segundo gerado ($0.1008)
Tempo médio: cerca de 400 s
IDs de modelo: kling/3.0/text-to-video
kling/3.0/image-to-video
kling/3.0/character-animation

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/3.0/text-to-video

Preço

Opção	Créditos (por segundo gerado)	Dólares
`generate_audio = false, resolution = 720p`	10.08	$0.1008
`generate_audio = false, resolution = 1080p`	13.44	$0.1344
`generate_audio = true, resolution = 720p`	15.12	$0.1512
`generate_audio = true, resolution = 1080p`	20.16	$0.2016
`generate_audio = false, resolution = 4k`	50.4	$0.504
`generate_audio = true, resolution = 4k`	50.4	$0.504

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 2.500 caracteres	Describe the scene, the action and the camera. With sound on, add dialogue in quotes and the sounds you want.
`negative_prompt`Opcional	`string`	—	até 2.500 caracteres	What to keep out of the clip: objects, looks or motion you do not want.
`aspect_ratio`Opcional	`string`	`16:9`	16:9, 9:16, 1:1	Output aspect ratio.
`resolution`Opcional	`string`	`720p`	720p, 1080p, 4k	Output resolution. Higher tiers cost more per second.
`generate_audio`Opcional	`boolean`	`false`	—	Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
`duration_seconds`Opcional	`integer`	`5`	de 3 a 15	Output length in whole seconds, from 3 to 15. Billed per second.
`shot_type`Opcional	`string`	`single`	single, multi, customize	single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.
`multi_prompt`Opcional	`array<object>`	—	até 6 itens	Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.
`guidance_scale`Opcional	`number`	`0.5`	de 0 a 1	How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; 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/3.0/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,
    "generate_audio": false,
    "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

kling/3.0/image-to-video

Preço

Opção	Créditos (por segundo gerado)	Dólares
`generate_audio = false, resolution = 720p`	10.08	$0.1008
`generate_audio = false, resolution = 1080p`	13.44	$0.1344
`generate_audio = true, resolution = 720p`	15.12	$0.1512
`generate_audio = true, resolution = 1080p`	20.16	$0.2016
`generate_audio = false, resolution = 4k`	50.4	$0.504
`generate_audio = true, resolution = 4k`	50.4	$0.504

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`prompt`Obrigatório	`string`	—	até 2.500 caracteres	Describe what happens after the opening frame: the action, the camera and, with sound on, the sounds.
`image_url`Obrigatório	`string (uri)`	—	—	Opening frame. The clip starts from this image.
`negative_prompt`Opcional	`string`	—	até 2.500 caracteres	What to keep out of the clip: objects, looks or motion you do not want.
`last_image_url`Opcional	`string (uri)`	—	—	Optional closing frame the clip should end on.
`resolution`Opcional	`string`	`720p`	720p, 1080p, 4k	Output resolution. Higher tiers cost more per second.
`generate_audio`Opcional	`boolean`	`false`	—	Generate a native soundtrack (voices, effects, ambience) with the picture. Audio costs more per second.
`duration_seconds`Opcional	`integer`	`5`	de 3 a 15	Output length in whole seconds, from 3 to 15. Billed per second.
`shot_type`Opcional	`string`	`single`	single, multi, customize	single keeps one continuous shot; multi lets the model cut the prompt into several shots on its own; customize follows the shot list you give in multi_prompt.
`multi_prompt`Opcional	`array<object>`	—	até 6 itens	Shot list for shot_type customize: one entry per shot, in order, each with its own prompt and length in seconds. The lengths must add up to duration_seconds.
`guidance_scale`Opcional	`number`	`0.5`	de 0 a 1	How closely the clip follows the prompt, from 0 to 1. Higher sticks to the prompt more; 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/3.0/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,
    "generate_audio": false,
    "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"

Controle de movimento

kling/3.0/character-animation

Preço

Opção	Créditos (por segundo gerado)	Dólares
`720p`	15.12	$0.1512
`1080p`	20.16	$0.2016

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`image_url`Obrigatório	`string (uri)`	—	—	The character to animate: one clear, full or half-body picture of the person.
`video_url`Obrigatório	`string (uri)`	—	—	Driving clip, 3 to 30 seconds: the moves, expressions and gestures to copy. The result is as long as this clip.
`prompt`Opcional	`string`	—	até 2.500 caracteres	Optional notes on the result: the setting, the look, anything the driving clip does not show.
`negative_prompt`Opcional	`string`	—	até 2.500 caracteres	What to keep out of the result: objects, looks or motion you do not want.
`resolution`Opcional	`string`	`720p`	720p, 1080p	Output resolution. Higher tiers cost more per second.
`keep_original_audio`Opcional	`boolean`	`true`	—	Keep the driving clip's own sound in the result.
`character_orientation`Opcional	`string`	`video`	video, image	Which way the character faces: video follows the person in the driving clip, image follows the person in the photo. With image the driving clip may be at most 10 seconds.
`shot_type`Opcional	`string`	`customize`	customize, intelligent	How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself.

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, video_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/3.0/character-animation",
  "input": {
    "prompt": "The person dances with relaxed, natural movement",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "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 Kling 3.0

Resumo

Criar vídeo

Preço

Parâmetros

Exemplo de requisição

Imagem para vídeo

Preço

Parâmetros

Exemplo de requisição

Controle de movimento

Preço

Parâmetros

Exemplo de requisição

Próximos passos

Nesta página