Kling 3.0 Turbo

Gere com o Kling 3.0 Turbo clipes de 3 a 15 segundos com áudio a partir de um prompt ou de um primeiro quadro, em 720p ou 1080p, cobrados por segundo e entregues como tarefa.

O Kling 3.0 Turbo é um modelo de vídeo da família Kling 3.0, da Kuaishou. Uma única requisição cria um clipe de 3 a 15 segundos com áudio a partir de um prompt, ou de um prompt mais um primeiro quadro, em 720p ou 1080p. Envie a requisição, guarde o ID da tarefa retornado e leia o vídeo pronto a partir da tarefa. As imagens são enviadas como URLs.

IDs de modelo

ID de modelo	Entradas	Resoluções	Duração
`kling-3-0-turbo`	texto, primeiro quadro	`720p`, `1080p`	De 3 a 15 segundos

Veja a página do modelo para os preços atuais.

Exemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

Cabeçalho	Valor
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

A resposta é uma tarefa ({"id": "task_...", "status": "processing"}), não o vídeo pronto. Consulte GET /v1/tasks/{task_id} para obter o resultado. Mantenha as chaves de API no código do lado do servidor.

Parâmetros

Campo	Tipo	Padrão	Observações
`model`	string	obrigatório	`kling-3-0-turbo`
`prompt`	string	obrigatório	Até 3.072 caracteres, ou 2.500 com um primeiro quadro. Obrigatório também com um primeiro quadro.
`first_frame_image`	URL	nenhum	O primeiro quadro do clipe. Sem ele, o clipe é de texto para vídeo.
`resolution`	enum	`720p`	`720p` ou `1080p`.
`duration`	integer	`5`	De 3 a 15 segundos.
`aspect_ratio`	enum	`16:9`	`16:9`, `9:16` ou `1:1`. Só texto para vídeo: com um primeiro quadro, o quadro define o formato.
`watermark`	boolean	nenhum	`true` adiciona uma marca d'água. Se omitido, o clipe não tem nenhuma.

Todo clipe vem com áudio; não existe ajuste de áudio. O esquema é estrito: campos desconhecidos são rejeitados em vez de ignorados. callback_url não está disponível; consulte a tarefa.

Imagem para vídeo

Passe um primeiro quadro em first_frame_image e descreva o que acontece em seguida em prompt. O clipe começa no quadro e assume o formato dele, então aspect_ratio não é usado.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

Entradas de mídia

O primeiro quadro é uma URL HTTP(S) pública. Data URIs em base64 não são aceitos: envie o arquivo para o seu próprio armazenamento e passe a URL dele. Use uma imagem JPG ou PNG de até 10 MB.

Fatores de custo

Veja a seção de preços do modelo para as tarifas atuais. O Kling 3.0 Turbo é cobrado por segundo de vídeo, com uma tarifa definida pela resolução:

cost = duration × rate per second for the resolution

A duração é conhecida quando a requisição é aceita, então o valor reservado é o valor cobrado. Veja as cobranças finais no histórico de uso da sua conta. Tarefas que falham não são cobradas.

Esquema de saída

O envio retorna a tarefa:

{"id": "task_...", "model": "kling-3-0-turbo", "status": "processing", "created_at": 1789689600}

Consultar a tarefa

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulte a cada 10–20 segundos até que status seja completed ou failed. Um tempo limite de rede durante a consulta não significa que a geração falhou: guarde o ID da tarefa e retome a verificação. Não crie outra tarefa para acompanhar o progresso.

Tarefa concluída

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nos nossos testes, clipes 720p de 3 segundos voltaram como MP4 (H.264) em 1280 × 720 e clipes 1080p de 5 segundos em 1920 × 1080, todos com uma faixa de áudio estéreo, entre 54 segundos e cerca de 5 minutos e 20 segundos depois do envio.

Erros

Requisições rejeitadas antes de uma tarefa ser criada retornam um erro HTTP com um objeto error e não são cobradas. Uma tarefa que falha depois de aceita retorna HTTP 200 quando consultada, com status: "failed" e um objeto error.

Veja o catálogo de erros comum para códigos, status HTTP e orientações de nova tentativa.

{
  "id": "task_...",
  "model": "kling-3-0-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se o próprio envio atingir o tempo limite, confira suas tarefas antes de enviar de novo: a primeira requisição pode ter sido aceita.

Dicas

Descreva assunto, lugar, movimento de câmera e luz com uma frase cada; o modelo segue a linguagem de câmera, como "aproximação lenta" e "contra-plongée".
Faça o rascunho em 720p e depois renderize a cena final em 1080p com a mesma requisição.
Com um primeiro quadro, descreva só o que se move: o quadro já define a cena.
Adicione no text, no logos para evitar marcas inventadas.