Skip to main content
POST

Autorização

string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • kling-v3 - Kling v3 (recomendado)
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Prompt de textoDescreva cenas, ações e estilos em detalhes para obter melhores resultados. Recomenda-se utilizar prompts em inglês.Exemplo: "a golden retriever running on the beach, sunset, cinematic"
string
Prompt negativo para excluir conteúdo indesejadoExemplo: "blurry, low quality, distorted"
string
padrão:"std"
Modo de geraçãoOpções:
  • std - Modo padrão (720P)
  • pro - Modo profissional (1080P)
  • 4k - Modo 4K
Padrão: std
integer
padrão:"5"
Padrão: 5 Duração do vídeo (segundos)Faixa: 3-15 (mínimo de 3 segundos, máximo de 15 segundos)⚠️ Nota: Deve ser um número simples (por exemplo, 6), sem aspas, caso contrário ocorrerá um erro
string
padrão:"16:9"
Proporção do vídeoOpções:
  • 16:9 - Paisagem
  • 9:16 - Retrato
  • 1:1 - Quadrado
Padrão: 16:9
array<url>
Array de URLs de imagens para geração image-to-video
  • Forneça 1 imagem: usada como primeiro frame
  • Forneça 2 imagens: atribuídas automaticamente como primeiro frame + último frame
Suporta no máximo 2 imagensExemplo: ["https://example.com/first.jpg"]
  • Suporta no máximo 2 imagens
  • As URLs das imagens devem ser publicamente acessíveis, sem proteção contra hotlink
  • No modo image-to-video, aspect_ratio pode ser substituído pela proporção real da imagem
boolean
Define se uma marca d’água deve ser adicionada
boolean
padrão:"false"
Define se o vídeo deve ser gerado com áudio
boolean
padrão:"false"
Define se o modo multi-shot (múltiplos planos) deve ser ativado.
  • true
  • false
string
Método de divisão de planos: customize / intelligence.Obrigatório quando multi_shot=true.
array<object>
Informações por plano, como prompt e duração.Defina a ordem, o prompt e a duração dos planos por meio de index, prompt e duration.
  • Suporta de 1 a 6 planos
  • O comprimento máximo do conteúdo por plano é 512
  • A duração de cada plano deve ser >= 1 e não pode exceder a duração total da tarefa
  • A soma das durações de todos os planos deve ser igual ao duration de nível superior
Formato:
Obrigatório quando multi_shot=true e shot_type=customize.
array<object>
Lista de sujeitos de referência, até 3 sujeitos.
  • Criados na hora via name, description, element_input_urls
Exemplo:
Observações:
  • Para criação na hora, name, description e element_input_urls são obrigatórios
  • element_input_urls: 2-4 imagens por sujeito (a primeira como imagem frontal, as demais como referências)
  • Referencie os elementos em prompt com @name, por exemplo, "@element_dog chasing @element_cat on grass"

Restrições de parâmetros

  • mode=4k é suportado para kling-v3
  • image_urls suporta até 2 imagens (1 primeiro frame, 2 primeiro+último frames)
  • Entrada apenas do último frame é inválida (deve incluir o primeiro frame)
  • Quando multi_shot=true, o prompt de nível superior pode ser omitido
  • multi_prompt suporta até 6 planos, e index deve começar em 1 e ser contínuo

Matriz de suporte de recursos

Texto para vídeo (Text-to-Video) vs Imagem para vídeo (Image-to-Video)

O sistema determina automaticamente o modo com base no fato de image_urls ser fornecido ou não: sem imagens significa text-to-video, com imagens significa image-to-video.

Resposta

integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta

Casos de uso

Caso 1: Texto para vídeo (Modo padrão)

Caso 2: Texto para vídeo (Modo Pro + prompt negativo)

Caso 3: Texto para vídeo (15 segundos)

Caso 4: Imagem para vídeo (Primeiro frame)

Caso 5: Imagem para vídeo (Controle de primeiro + último frame)

Caso 6: Gerar vídeo com áudio

Caso 7: Storyboard multi-shot (customize, 15 segundos, vertical com áudio)

Consultar os resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um task_id ao ser submetida. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.