Créer une tâche Kling de text-to-video
Générez des vidéos à partir de prompts textuels avec Kling via CometAPI POST /kling/v1/videos/text2video, puis suivez l’état de la tâche et récupérez les résultats par ID de tâche.
Première requête fonctionnelle
- Envoyez d’abord un prompt court
- Commencez par l’exemple
kling-v3, puis choisissez un autremodel_namedans l’enum OpenAPI lorsque vous avez besoin d’une autre variante de modèle - Ajoutez
aspect_ratio,duration,modeousounduniquement une fois que le flux de base fonctionne - Définissez
callback_urlsi vous souhaitez une livraison push au lieu d’un simple polling - Utilisez
sound: offsi vous souhaitez une première requête déterministe sans audio sur les modèles qui prennent en charge le son généré
Nommage des modèles
Utilisez les model IDs vidéo Kling ordinaires sur cet endpoint. Réservez les model IDs Omni pour Omni Video.Durée et ratio d’aspect
size exact. Le ratio d’aspect demandé contrôle la forme de l’image de sortie.
Flux de tâche
Soumettre la requête de génération
Interroger l’état de la tâche
Conserver le résultat
Autorisations
Bearer token authentication. Use your CometAPI key.
En-têtes
Must be application/json.
Corps
Text prompt describing the video to generate. Maximum 500 characters.
Elements to exclude from the video. Maximum 200 characters.
Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.
16:9, 9:16, 1:1 Webhook URL to receive task status updates when the task completes.
Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.
kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6, kling-v3 Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.
Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.
std, pro Output video length in seconds. Use 5 or 10; omit to use 5.
Camera motion preset or manual configuration. Omit for automatic camera movement.
Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.
Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.
on, off