Vídeo
Kling 3.0 video
Kling 3.0 — Standard/Pro tiers. Text + image-to-video (start + end frame OR reference), multi-shot and @elements. 3–15s.
Categoria: Criação · kling-3-0
Como usar & limites
- Texto-para-vídeo e imagem-para-vídeo (image_urls até 2: frame inicial e final).
- prompt: até 2.500 caracteres; duração inteira de 3 a 15 segundos.
- quality: standard, pro ou 4K.
- sound liga o áudio; com multi_shots ligado, sound precisa ser true.
- multi_shots + multi_prompt fazem narrativa por cenas (soma das durações ≤ 15s).
- kling_elements define elementos reutilizáveis citados no prompt como @nome (exige image_urls).
- aspect_ratio: 1:1, 16:9 ou 9:16 (ignorado com imagem única).
Capacidades
O que este modelo suporta, direto do schema — sem preços, sem detalhes de infraestrutura.
| Capacidade | Valor |
|---|---|
video_edit Edição de vídeo | — |
multi_shots Múltiplos planos | Sim |
multi_prompt Multi-prompt | Sim |
native_audio Áudio nativo | Sim |
text_to_video Texto → vídeo | Sim |
image_to_video Imagem → vídeo | Sim |
kling_elements Elementos multi-referência | Sim |
max_prompt_length Tamanho máx. do prompt | 2500 |
reference_to_video Referência → vídeo | — |
multi_prompt_supported Multi-prompt | Sim |
Parâmetros
Campos aceitos em params (ou de primeira classe, quando aplicável) para POST /generations.
| Nome | Rótulo | Tipo | Obrigatório | Padrão | Opções | Mín / Máx | Descrição |
|---|---|---|---|---|---|---|---|
prompt | Prompt | textarea | Opcional | — | — | — | Descrição da cena; até 2.500 caracteres. |
multi_shots | Multi-shot | boolean | Opcional | false | — | — | Ativa narrativa multi-cena; exige sound=true. |
multi_prompt | Per-shot prompts | text | Opcional | — | — | — | Prompts por cena com durações; soma ≤ 15s. |
image_urls | Image references | multi_select | Opcional | — | — | — – 2 | Até 2 imagens: frame inicial e frame final. |
kling_elements | Elements | text | Opcional | — | — | — | Elementos reutilizáveis citados como @nome no prompt. |
sound | Sound | boolean | Opcional | true | — | — | Liga o áudio; obrigatório true em multi-cena. |
quality | Quality | select | Opcional | standard | standard · pro · 4K | — | Nível: standard (~720p), pro (1080p) ou 4K. |
negative_prompt | Negative prompt | textarea | Opcional | — | — | — | Termos a evitar na geração. |
duration | Duration | number | Obrigatório | 5 | — | 3 – 15 | Duração em segundos, inteiro de 3 a 15. |
aspect_ratio | Aspect ratio | select | Opcional | 1:1 | 1:1 · 16:9 · 9:16 | — | Proporção: 1:1, 16:9 ou 9:16. |
Exemplo de requisição
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3-0",
"prompt": "Um dragão sobrevoa uma cidade medieval ao amanhecer, planos amplos e cinematográficos.",
"params": {
"duration": 5,
"sound": true,
"aspect_ratio": "1:1",
"quality": "standard"
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "kling-3-0",
"prompt": "Um dragão sobrevoa uma cidade medieval ao amanhecer, planos amplos e cinematográficos.",
"params": {
"duration": 5,
"sound": true,
"aspect_ratio": "1:1",
"quality": "standard"
}
}),
});
const { data } = await res.json();
Exemplo de resposta
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "kling-3-0",
"type": "video",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
O custo real do job é retornado em credits_charged na resposta concluída — consulte GET /balance para o saldo da conta.
Erros comuns deste tipo de job:
insufficient_credits | Saldo insuficiente para cobrir o job. |
content_policy_violation | Prompt ou mídia recusados por política de conteúdo. |
generation_timeout | O job excedeu o tempo máximo de processamento. |
rate_limited | Limite de requisições por minuto excedido. |
invalid_input | Parâmetro obrigatório ausente ou fora do schema do modelo. |
generation_failed | Falha genérica no processamento do job. |