Kling 4.0 Flash

Kling 4.0 Flash é o membro mais leve da família Kling 4.0 da Kuaishou. No SeedRouter, ele cobre texto para vídeo e geração baseada em referências: até 10 imagens de referência, até 5 vídeos de referência e até 7 elementos (sujeitos com nome criados a partir de 2–4 imagens ou um vídeo curto), cada um mencionado no prompt. Cada clipe tem 3–20 segundos em 720p com som. Envie a requisição, guarde o ID de tarefa retornado e leia o vídeo terminado da tarefa. A mídia entra 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-4-0-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "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 terminado. Consulte GET /v1/tasks/{task_id} para o resultado. Guarde chaves de API no código do servidor.

Parâmetros

Cada clipe vem com som; não há interruptor de som. Não há campos de primeiro quadro, quadro intermediário ou último quadro, nem negative_prompt, watermark ou um campo voices independente: vincule uma voz a um elemento com voice_url. O schema é rigoroso: campos desconhecidos são rejeitados em vez de ignorados. callback_url não está disponível; consulte a tarefa em vez disso.

Menções

Todos os recursos que você envia são opcionais; sem nenhum, a requisição é apenas de texto para vídeo. Quando enviar recursos, faça referência a eles no prompt:

Todo @ seguido de uma letra, dígito, sublinhado ou caractere chinês deve nomear um recurso desta requisição, ou ela será rejeitada antes de qualquer cobrança. Os nomes são comparados do mais longo para o mais curto e sem distinguir maiúsculas de minúsculas. Um nome que termine em letra, dígito ou sublinhado não pode ser seguido imediatamente por outro desses caracteres: @image_12 com uma única imagem é rejeitado; escreva @image_1 2 ou @image_1,.

Vídeos de referência e elementos de vídeo somam no máximo 5, e imagens, vídeos e elementos juntos somam no máximo 15.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

Elementos

Um elemento é um sujeito com nome que você pode reutilizar no prompt. Há dois tipos:

Os nomes têm de 1 a 20 letras, dígitos, sublinhados ou caracteres chineses e devem ser únicos sem distinguir maiúsculas de minúsculas. image_N, video_N, keyframe_N, object_N, audio_N, first_frame e last_frame são reservados.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

Entradas de mídia

Imagens, vídeos e áudio são URLs HTTP(S) públicas. URIs de dados base64 não são aceitas: carregue os arquivos em seu próprio armazenamento e passe suas URLs. Vídeos de referência e elementos de vídeo juntos devem ter de 2 a 20 segundos de duração; sua duração é lida quando a requisição é aceita, e um vídeo cuja duração não pode ser lida é rejeitado antes de qualquer cobrança.

Dimensões de preço

Verifique a seção de preço do modelo para as tarifas atuais. Kling 4.0 Flash é cobrado por segundo de vídeo em 720p:

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

input é a duração somada dos vídeos de referência e elementos de vídeo, arredondada para cima para segundos inteiros. É medida quando a requisição é aceita, portanto o valor reservado é o valor cobrado. Exemplo: um clipe de 5 segundos guiado por um vídeo de referência de 7,2 segundos cobra 5 + 8 = 13 segundos; com um vídeo de referência de 3 segundos, cobra 5 + 5 = 10 segundos. As tarefas com falha não são cobradas.

Esquema de saída

O envio retorna a tarefa:

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

Obter a tarefa

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

Consulte a cada 10–20 segundos até status ser 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 verificar o progresso.

Tarefa concluída

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

Em nossos testes, clipes de 5 segundos retornaram como MP4 (H.264) em 1280 × 720 com uma faixa AAC estéreo, 91–103 segundos após o envio; o arquivo dura aproximadamente um quadro a mais que duration (5,04 segundos para 5).

Erros

As 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 após a aceitação retorna HTTP 200 quando consultada, com status: "failed" e um objeto error.

Veja o catálogo de erros compartilhado para códigos, status HTTP e orientação de tentativa.

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

Se o envio em si expirar, verifique suas tarefas antes de enviar novamente: a primeira requisição pode ter sido aceita.

Dicas

• Descreva assunto, lugar, movimento de câmera, luz e som; o áudio do clipe segue o prompt.
• Use o Flash para experimentar prompts, proporções e referências a baixo custo; depois passe a tomada que funcionar para o Kling 4.0 quando precisar de 1080p, quadros-chave, edição ou extensão.
• Dê a um personagem recorrente um elemento com duas ou três vistas claras em vez de uma imagem de referência.
• Adicione no text, no logos para manter marcas inventadas fora do vídeo.

Relacionado

• Playground e preços do Kling 4.0 Flash
• Referência da API do Kling 4.0
• Baixar OpenAPI
• Markdown copiável