Kling 4.0 API

Referencia completa de la API de los modelos de generación de vídeo Kling 4.0 de Kuaishou.

Variantes del modelo

Esta API admite cinco variantes del modelo:

Comparación rápida

Relaciones de aspecto admitidas

Text-to-Video, Image-to-Video, Reference-to-Video y Video Edit admiten:

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

El valor predeterminado es 16:9. Video Extend no admite el parámetro aspect_ratio; la salida conserva la relación de aspecto del vídeo de origen.

Opciones de resolución

Los cinco modelos requieren resolution y duration. Incluya resolution explícitamente aunque su valor predeterminado sea 720p. duration no tiene un valor predeterminado.

Kling 4.0 Text to Video

Punto de conexión

POST /api/v1/video/task

Parámetros de la solicitud

Obligatorios

Opcionales

Ejemplo de solicitud

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 de la solicitud

Obligatorios

Opcionales

Si se proporcionan tanto image_url como image_end_url, key_frames puede contener como máximo 8 imágenes. Los fotogramas intermedios se utilizan en el orden del array; el modelo determina su posición temporal.

Ejemplo de solicitud

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 de la solicitud

Obligatorios

Opcionales

Las imágenes, los vídeos y el audio de referencia son opcionales. Proporcione un único tipo de medio, combine varios tipos u omita los tres.

El valor duration de salida se establece de forma independiente entre 3 y 30 segundos y no cuenta para el límite de duración combinada de los vídeos de referencia.

Ejemplo de solicitud

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 de la solicitud

Obligatorios

Opcionales

Ejemplo de solicitud

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 de la solicitud

Obligatorios

Opcionales

No envíe aspect_ratio; la salida conserva la relación de aspecto del vídeo de origen. El resultado contiene el vídeo completo, incluidos el vídeo de origen y la extensión. Su duración total es la duración del vídeo de origen más duration.

Ejemplo de solicitud

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
}

Reglas de facturación

Text-to-Video e Image-to-Video se facturan según la resolución de salida y la duración del vídeo generado. Video Extend se factura según la resolución y la duración del segmento añadido, no según la duración total del vídeo devuelto.

Las solicitudes de Reference-to-Video que contienen vídeos de referencia y las solicitudes de Video Edit tienen en cuenta la duración de los vídeos de entrada y de salida a la resolución seleccionada. La duración facturada del vídeo de entrada tiene un mínimo de 3 segundos y un máximo de 30 segundos. Si hay varios vídeos de referencia, estos límites se aplican a su duración combinada, no a cada vídeo por separado. Los límites de duración facturada no definen los límites de carga.

Sin vídeos de referencia, Reference-to-Video utiliza las mismas reglas de facturación que Text-to-Video, se proporcionen o no imágenes o audio de referencia. En las solicitudes con vídeo de entrada, las imágenes de referencia admitidas, el audio de referencia y keep_original_sound no generan cargos independientes.

Formato de respuesta

Respuesta inicial

Todos los modelos devuelven un task_id para realizar 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"
  }
}

Realice consultas periódicas con GET /api/v1/video/{task_id} para comprobar el estado y obtener el vídeo generado.

Valores de estado

• submitted: tarea aceptada y en espera de procesamiento
• processing: generación de vídeo en curso
• succeed: generación de vídeo completada
• failed: error en la generación de vídeo

Buenas prácticas

1. Parámetros obligatorios: proporcione siempre resolution y duration, incluso cuando utilice la resolución predeterminada 720p
2. Número de fotogramas: limite el total de fotogramas inicial, final e intermedios a 10 o menos
3. Medios de referencia: respete las cantidades y duraciones documentadas para los medios de referencia
4. Sonido original: utilice keep_original_sound solo para Reference-to-Video o Video Edit
5. Extensión de vídeo: establezca duration en la duración adicional y omita aspect_ratio