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-omni - Kling v3 Omni (interface unificada)
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 texto positivoSuporta referência a imagens de image_urls usando a sintaxe <<<image_N>>>, onde N começa em 1.Exemplo: "Make the person in <<<image_1>>> wave at the camera"
Se imagens forem fornecidas, mas o prompt não contiver nenhuma referência <<<image_N>>>, o sistema adicionará automaticamente <<<image_1>>> no início do prompt.
string
Prompt negativo usado para excluir conteúdo indesejado. Comprimento máximo de 2500 caracteres.
string
padrão:"std"
Modo de geraçãoOpções:
  • std - Modo padrão (720P)
  • pro - Modo profissional (1080P)
  • 4k - Modo 4K ultra HD
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 referenciamento de imagensReferencie as imagens correspondentes no prompt usando a sintaxe <<<image_N>>> (N começa em 1)Exemplo: ["https://example.com/photo.jpg"]
  • 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
array<object>
Array de imagens baseado em papéis, recomendado para image-to-video.Formato de cada item: { "url": "...", "role": "..." }
  • first_frame: primeiro frame
  • last_frame: último frame
  • reference: imagem de referência
image_urls e image_with_roles são mutuamente exclusivos. Use apenas um.
array
Lista de vídeos de referência (baseada em URLs), até 1 vídeo.Use refer_type para distinguir os tipos:
  • base: vídeo a ser editado (padrão)
  • feature: vídeo de referência por característica
Use keep_original_sound para controlar o áudio original:
  • no: não manter (padrão)
  • yes: manter o áudio original
Formato da requisição:
  • video_url não pode estar vazio, e a URL do vídeo deve ser acessível
  • Quando refer_type=base:
    • Não é possível definir frames inicial/final
    • O vídeo de referência deve ter de 3 a 10 segundos
    • A duração do vídeo gerado segue o vídeo enviado
  • Quando refer_type=feature e video_url não está vazio:
    • image_urls só pode incluir uma imagem de primeiro frame
  • Requisitos do vídeo: apenas MP4/MOV; duração de pelo menos 3 segundos; resolução de 720px-2160px; taxa de quadros de 24-60fps (a saída é 24fps); tamanho não superior a 200MB
boolean
padrão:"false"
Define se o modo multi-shot (múltiplos planos) deve ser ativado.
string
Método de divisão de planos: customize / intelligence.Obrigatório quando multi_shot=true.
array<object>
Lista multi-shot, cada item é { index, prompt, duration }.
  • Mínimo 1 plano, máximo 6 planos
  • Cada duration de plano deve ser um inteiro e >= 1
  • A soma das durações de todos os planos deve ser igual ao duration de nível superior
  • index deve começar em 1 e aumentar continuamente
  • Obrigatório quando multi_shot=true e shot_type=customize
Exemplo:
array<object>
Lista de sujeitos de referência, até 3 sujeitos. Suporta:
  • Criar sujeitos na hora com name, description, element_input_urls
Formato comum:
Observações:
  • Para criação na hora, name, description, element_input_urls são obrigatórios
  • element_input_urls: 2 a 4 imagens por sujeito (a primeira como imagem frontal, as demais como referências)
  • Use @name em prompt, por exemplo, "@element_dog and @element_cat are playing on the grass"
boolean
Define se uma marca d’água deve ser adicionada
boolean
padrão:"false"
Define se o vídeo deve ser gerado com áudio
Este parâmetro é mutuamente exclusivo com video_list.Quando video_list tem um valor, o parâmetro audio não é necessário.

Restrições e limites de parâmetros

  • image_urls e image_with_roles são mutuamente exclusivos
  • mode=4k está disponível para kling-v3-omni
  • Entrada apenas do último frame (last_frame sem o primeiro frame) é inválida
  • Frames inicial/final e edição de vídeo são mutuamente exclusivos: quando video_list.refer_type=base (ou omitido), frames inicial/final não são permitidos
  • Quando video_list está presente, audio é ignorado
  • video_list suporta no máximo 1 vídeo
  • multi_prompt suporta até 6 planos, com index começando em 1 e aumentando continuamente

Sintaxe de referência de imagens

O modelo Omni usa a sintaxe <<<image_N>>> para referenciar imagens nos prompts, oferecendo uma experiência unificada de text-to-video/image-to-video:
Referência automática: Se image_urls for fornecido, mas o prompt não contiver nenhuma referência <<<image_N>>>, o sistema adicionará automaticamente <<<image_1>>> no início do prompt.

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: Referência de imagem (uma imagem)

Caso 3: Múltiplas referências de imagens

Caso 4: Imagem fornecida sem referência explícita (adicionada automaticamente)

O sistema adicionará automaticamente <<<image_1>>> no início do prompt, equivalente a "<<<image_1>>>The person slowly turns and smiles".

Caso 5: Gerar vídeo com áudio

Nota: audio é mutuamente exclusivo com video_list. Quando video_list tem um valor, o parâmetro audio não é necessário.
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.