Kling 4.0 API

Referência completa da API dos modelos de geração de vídeo Kling 4.0 da Kuaishou.

Variantes do modelo

Esta API oferece suporte a cinco variantes do modelo:

Comparação rápida

Proporções compatíveis

Text-to-Video, Image-to-Video, Reference-to-Video e Video Edit são compatíveis com:

16:9, 9:16, 1:1, 21:9

O padrão é 16:9. Video Extend não aceita o parâmetro aspect_ratio; a saída segue a proporção do vídeo de origem.

Opções de resolução

Todos os cinco modelos exigem resolution e duration. Inclua resolution explicitamente, mesmo que o valor padrão seja 720p. duration não tem valor padrão.

Kling 4.0 Text to Video

Ponto de acesso

POST /api/v1/video/task

Parâmetros da solicitação

Obrigatórios

Opcionais

Exemplo de solicitação

javascriptCopiar
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-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Kling 4.0 Image to Video

Parâmetros da solicitação

Obrigatórios

Opcionais

Quando image_url e image_end_url são fornecidos, key_frames pode conter no máximo 8 imagens. Os quadros intermediários são usados na ordem do array; seu posicionamento temporal é determinado pelo modelo.

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

Parâmetros da solicitação

Obrigatórios

Opcionais

Imagens, vídeos e áudio de referência são todos opcionais. Forneça qualquer um dos tipos de mídia, combine os tipos ou omita os três.

A duration de saída é definida de forma independente entre 3-30 segundos e não conta para o limite de duração combinada dos vídeos de referência.

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

Parâmetros da solicitação

Obrigatórios

Opcionais

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

Parâmetros da solicitação

Obrigatórios

Opcionais

Não envie aspect_ratio; a saída segue a proporção do vídeo de origem. O resultado contém o vídeo completo, incluindo o vídeo de origem e a extensão. Sua duração total é a duração do vídeo de origem mais duration.

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

Regras de cobrança

Text-to-Video e Image-to-Video são cobrados de acordo com a resolução de saída e a duração do vídeo gerado. Video Extend é cobrado de acordo com a resolução e a duração do segmento adicionado, e não pela duração total do vídeo retornado.

As solicitações de Reference-to-Video que contêm vídeos de referência e as solicitações de Video Edit consideram a duração dos vídeos de entrada e de saída na resolução selecionada. A duração mínima cobrada do vídeo de entrada é de 3 segundos e a máxima é de 30 segundos. Para vários vídeos de referência, esses limites se aplicam à duração combinada, e não a cada vídeo separadamente. Os limites de duração para cobrança não definem os limites de envio.

Sem vídeos de referência, Reference-to-Video usa as mesmas regras de cobrança de Text-to-Video, independentemente de serem fornecidos imagens ou áudio de referência. Nas solicitações com vídeo de entrada, as imagens de referência, o áudio de referência e keep_original_sound compatíveis não geram cobranças adicionais.

Formato da resposta

Resposta inicial

Todos os modelos retornam um task_id para consultas periódicas:

jsonCopiar
{
  "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 do vídeo em andamento
• succeed: Geração do vídeo concluída
• failed: Falha na geração do vídeo

Boas práticas

1. Parâmetros obrigatórios: Sempre forneça resolution e duration, inclusive ao usar a resolução padrão 720p
2. Número de quadros: Mantenha o total dos quadros inicial, final e intermediários em 10 ou menos
3. Mídia de referência: Respeite as quantidades e durações de mídia de referência indicadas na documentação
4. Som original: Use keep_original_sound apenas para Reference-to-Video ou Video Edit
5. Extensão de vídeo: Defina duration como a duração adicional e omita aspect_ratio