Kling 3.0

O Kling 3.0 é o modelo de geração de vídeo da Kuaishou. Uma única requisição cria um clipe de 3 a 15 segundos a partir de um prompt, ou de um primeiro quadro e um último quadro opcional, em três modos de qualidade (std, pro, 4K), com áudio nativo quando você pede. Um clipe também pode ser uma sequência de até cinco cenas, cada uma com seu próprio prompt e duração. 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

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",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Endpoint

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

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

O esquema é estrito: campos desconhecidos são rejeitados em vez de ignorados. callback_url não está disponível; consulte a tarefa.

Clipes multicena

Defina multi_shots como true e descreva cada cena em multi_prompt. As durações das cenas precisam somar de 3 a 15 segundos; essa soma é a duração do clipe, e duration não é usado. prompt pode ser omitido ou usado para o que todas as cenas têm em comum.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

Elementos

Um elemento é um assunto que o modelo mantém consistente ao longo do clipe: uma pessoa, um produto ou um personagem. Dê a ele um name, uma description curta e 2 a 4 imagens dele e depois mencione-o pelo nome no prompt (por exemplo, @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Entradas de mídia

Toda imagem é 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 imagens 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 é cobrado por segundo de vídeo, com uma tarifa definida pelo modo e por sound estar ativado ou não:

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

Os segundos cobrados são conhecidos 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", "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",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nos nossos testes, um clipe std de 3 segundos voltou como MP4 (H.264) em 1280 × 720, e um clipe pro de 5 segundos com sound em 1920 × 1080 com faixa de áudio, cada um em cerca de dois a três minutos.

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",
  "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 Kling segue a linguagem de câmera, como "aproximação lenta" e "contra-plongée".
• Faça o rascunho em std e depois renderize a cena final em pro ou 4K com a mesma requisição.
• Use um primeiro e um último quadro para controlar onde a cena começa e termina.
• Divida uma sequência em cenas com multi_prompt em vez de descrever vários cortes em um único prompt.
• Adicione no text, no logos para evitar marcas inventadas.

Relacionados

• Playground e preços do Kling 3.0
• Baixar o OpenAPI
• Markdown copiável