Texte vers vidéo

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.

POST /kling/v1/videos/text2video

Text to Video

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A happy scene of a vacation on the beach."
}
'

200

{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Utilisez cet endpoint pour créer une tâche Kling de génération de vidéo à partir d’un prompt. Il lance un job asynchrone au lieu de renvoyer immédiatement une vidéo finalisée.

​

Première requête fonctionnelle

• Envoyez d’abord un prompt court
• Ajoutez aspect_ratio, duration ou mode uniquement une fois le flux de base validé
• Définissez callback_url si vous souhaitez une livraison par push plutôt qu’un simple polling

​

Flux de la tâche

1. Soumettre la requête de génération

   Créez la tâche via cet endpoint et enregistrez l’identifiant de tâche Kling renvoyé.

2. Interroger l’état de la tâche

   Vérifiez la progression via Individual Queries jusqu’à ce que la tâche atteigne un état terminal.

3. Conserver le résultat

   Une fois que Kling renvoie les métadonnées de l’asset finalisé, déplacez le résultat vers votre propre stockage si vous avez besoin d’une conservation longue durée.

Pour la matrice complète des paramètres et les détails des pistes de modèle, consultez la documentation officielle de Kling. Utilisez les formats de requête et de réponse de cette page comme référence pour le wrapper CometAPI.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

En-têtes

Content-Type · string

Must be application/json.

Corps

application/json

prompt · string · défaut: Hello · requis

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt · string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio · string

Output aspect ratio (width:height). Options: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

callback_url · string

Webhook URL to receive task status updates when the task completes.

model_name · string

Kling model variant to use. See the Models page for current options.

cfg_scale · number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

mode · enum<string>

Generation mode. std for standard (faster), pro for professional (higher quality).

Options disponibles: std, pro

duration · string

Output video length in seconds. Options: 5, 10.

camera_control · object

Camera motion preset or manual configuration. Omit for automatic camera movement.

Show child attributes

external_task_id · string

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.

Réponse

200 - application/json

Successful Response

code · integer

Error code; specifically define the error code

message · string

error message

request_id · string

Request ID, system-generated, for tracking requests, troubleshooting issues

data · object

Show child attributes