API Kling 2.6 Motion Control

Referência completa da API de geração de vídeos com Kling 2.6 Motion Control da Kuaishou.

Variantes do modelo

Esta API oferece suporte a uma variante do modelo:

Modelo	ID	Descrição
Kling 2.6 Motion Control	`kling-2.6-motion-control`	Geração de vídeos usando um prompt de texto, uma imagem de referência e um vídeo de referência

Kling 2.6 Motion Control

Ponto de acesso

POST /api/v1/video/task

Parâmetros da solicitação

Obrigatórios

Parâmetro	Tipo	Descrição
`model_name`	string	Deve ser `"kling-2.6-motion-control"`
`prompt`	string	Prompt de geração de vídeo, com até 5000 caracteres
`images`	string[]	Exatamente uma URL de imagem de referência. Aceita `.jpg`, `.jpeg` e `.png`; o tamanho do arquivo não deve exceder 50 MB. A largura e a altura devem ser de pelo menos 300 px cada, com proporção da imagem entre 1:2.5 e 2.5:1
`videos`	string[]	Exatamente uma URL de vídeo de referência. Aceita `.mp4` e `.mov`; o tamanho do arquivo não deve exceder 100 MB. A largura e a altura devem estar entre 340 e 3850 px cada, inclusive. A duração deve ser de pelo menos 3 segundos; o máximo depende de `character_orientation`
`character_orientation`	string	Obrigatório, sem valor padrão. `"image"`: segue a orientação do personagem na imagem de referência; o vídeo de referência deve ter 3-10 segundos. `"video"`: segue a orientação do personagem no vídeo de referência; o vídeo de referência deve ter 3-30 segundos. Ambos os intervalos de duração incluem seus limites
`resolution`	string	Resolução de saída: `"720p"` ou `"1080p"`. Obrigatório, sem valor padrão

Opcionais

Parâmetro	Tipo	Descrição
`keep_original_sound`	boolean	Define se o áudio original do vídeo de referência deve ser mantido. Aceita `true` ou `false`; o padrão é `true`

A duração da saída segue a do vídeo de origem. O parâmetro duration não é compatível. A proporção da saída é determinada pelas mídias de entrada, e aspect_ratio não é compatível. O provedor de origem não especificou qual entrada determina a proporção da saída nem a regra exata de seleção.

A cobrança é baseada na duração do vídeo de origem arredondada para o segundo inteiro mais próximo e na resolução de saída selecionada. Por exemplo, 5,4 segundos são cobrados como 5 segundos, e 5,5 segundos como 6 segundos.

Exemplo de solicitação

Substitua as URLs de mídia do exemplo pelas URLs dos seus próprios arquivos que atendam aos requisitos acima.

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-2.6-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Formato da resposta

Resposta inicial

Retorna um task_id para consulta periódica:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Faça consultas periódicas com GET /api/v1/video/{task_id} para verificar o status e obter o vídeo gerado.

Valores de status

submitted: Tarefa aceita e aguardando processamento
processing: Geração de vídeo em andamento
succeed: Geração de vídeo concluída
failed: Falha na geração de vídeo

Boas práticas

Mídias de referência: Forneça exatamente uma imagem e um vídeo, verificando seus formatos, tamanhos de arquivo e dimensões antes do envio
Orientação: Verifique novamente a duração do vídeo de referência ao alterar character_orientation, especialmente ao selecionar "image"
Áudio original: Defina keep_original_sound como false para não manter o áudio original do vídeo de referência; omitir o parâmetro mantém o áudio