Passer au contenu principal
POST
/
kling
/
v1
/
videos
/
text2video
Text to Video
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."
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Utilisez ce endpoint pour créer une tâche Kling de génération de vidéo à partir d’un texte depuis un prompt. Cela 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 seulement après avoir validé le flux de base
  • Définissez callback_url si vous souhaitez une livraison par push au lieu d’un simple polling

​
Flux de la tâche

1

Soumettre la requête de génération

Créez la tâche via ce endpoint et enregistrez l’id de tâche Kling renvoyé.
2

Interroger l’état de la tâche

Vérifiez la progression via Requêtes individuelles 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 la ressource finalisée, 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 sur les tracks de modèles, consultez la documentation officielle de Kling.

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.

​
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