Kling 4.0 API

Référence complète de l’API des modèles de génération vidéo Kling 4.0 de Kuaishou.

Variantes du modèle

Cette API prend en charge cinq variantes du modèle :

Comparaison rapide

Formats d’image pris en charge

Text-to-Video, Image-to-Video, Reference-to-Video et Video Edit prennent en charge :

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

La valeur par défaut est 16:9. Video Extend ne prend pas en charge le paramètre aspect_ratio ; la sortie conserve le format d’image de la vidéo source.

Résolutions disponibles

Les cinq modèles exigent resolution et duration. Indiquez explicitement resolution, même si sa valeur par défaut est 720p. duration n’a pas de valeur par défaut.

Kling 4.0 Text to Video

Point de terminaison

POST /api/v1/video/task

Paramètres de la requête

Obligatoires

Facultatifs

Exemple de requête

javascriptCopier
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

Paramètres de la requête

Obligatoires

Facultatifs

Lorsque image_url et image_end_url sont tous deux fournis, key_frames peut contenir au maximum 8 images. Les images intermédiaires sont utilisées dans l’ordre du tableau ; leur position temporelle est déterminée par le modèle.

Exemple de requête

javascriptCopier
{
  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

Paramètres de la requête

Obligatoires

Facultatifs

Les images, les vidéos et l’audio de référence sont tous facultatifs. Fournissez un seul type de média, combinez plusieurs types ou omettez les trois.

La valeur duration de sortie est définie indépendamment entre 3 et 30 secondes et n’entre pas dans la limite de durée cumulée des vidéos de référence.

Exemple de requête

javascriptCopier
{
  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

Paramètres de la requête

Obligatoires

Facultatifs

Exemple de requête

javascriptCopier
{
  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

Paramètres de la requête

Obligatoires

Facultatifs

N’envoyez pas aspect_ratio ; la sortie conserve le format d’image de la vidéo source. Le résultat contient la vidéo complète, y compris la source et le prolongement. Sa durée totale correspond à la durée de la vidéo source plus duration.

Exemple de requête

javascriptCopier
{
  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
}

Règles de facturation

Text-to-Video et Image-to-Video sont facturés selon la résolution de sortie et la durée de la vidéo générée. Video Extend est facturé selon la résolution et la durée du segment ajouté, et non selon la durée totale de la vidéo renvoyée.

Les requêtes Reference-to-Video contenant des vidéos de référence et les requêtes Video Edit prennent en compte la durée des vidéos d’entrée et de sortie à la résolution sélectionnée. La durée facturée de la vidéo d’entrée est comprise entre un minimum de 3 secondes et un maximum de 30 secondes. En présence de plusieurs vidéos de référence, ces limites s’appliquent à leur durée cumulée, et non à chaque vidéo séparément. Les limites de durée facturée ne définissent pas les limites de téléversement.

Sans vidéos de référence, Reference-to-Video utilise les mêmes règles de facturation que Text-to-Video, que des images ou de l’audio de référence soient fournis ou non. Pour les requêtes avec une vidéo en entrée, les images de référence prises en charge, l’audio de référence et keep_original_sound n’entraînent pas de frais distincts.

Format de la réponse

Réponse initiale

Tous les modèles renvoient un task_id pour les interrogations périodiques :

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

Interrogez périodiquement GET /api/v1/video/{task_id} pour vérifier l’état et récupérer la vidéo générée.

Valeurs d’état

• submitted : tâche acceptée et en attente de traitement
• processing : génération vidéo en cours
• succeed : génération vidéo terminée
• failed : échec de la génération vidéo

Bonnes pratiques

1. Paramètres obligatoires : fournissez toujours resolution et duration, y compris lorsque vous utilisez la résolution par défaut 720p
2. Nombre d’images : limitez l’ensemble constitué de la première image, de l’image finale et des images intermédiaires à 10 images ou moins
3. Médias de référence : respectez les nombres et les durées documentés pour les médias de référence
4. Son d’origine : utilisez keep_original_sound uniquement pour Reference-to-Video ou Video Edit
5. Prolongement vidéo : définissez duration sur la durée supplémentaire et omettez aspect_ratio