> ## 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.
# 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.
Utilisez cet endpoint pour créer une tâche Kling de text-to-video à 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
* Commencez par l’exemple `kling-v3`, puis choisissez un autre `model_name` dans l’enum OpenAPI lorsque vous avez besoin d’une autre variante de modèle
* Ajoutez `aspect_ratio`, `duration`, `mode` ou `sound` uniquement une fois que le flux de base fonctionne
* Définissez `callback_url` si vous souhaitez une livraison push au lieu d’un simple polling
* Utilisez `sound: off` si 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](./omni-video).
## Durée et ratio d’aspect
| Paramètre | Valeurs prises en charge | Par défaut | Comportement aux limites |
| -------------- | ------------------------ | --------------------------- | ------------------------------------------------------------------------------------ |
| `duration` | `5`, `10` | `5` | Les autres valeurs sont en dehors du schéma de requête text-to-video. |
| `aspect_ratio` | `16:9`, `9:16`, `1:1` | `16:9` | Utilisez le ratio correspondant à votre surface de diffusion. |
| `mode` | `std`, `pro` | `std` | `pro` améliore la qualité et coûte plus cher. |
| `sound` | `on`, `off` | valeur par défaut du modèle | S’applique uniquement aux variantes de modèle qui prennent en charge l’audio généré. |
Cet endpoint n’expose pas de jeton de résolution distinct ni de champ `size` exact. Le ratio d’aspect demandé contrôle la forme de l’image de sortie.
| `aspect_ratio` | `WxH` typique du rendu |
| -------------- | ---------------------- |
| `16:9` | `1280x720` |
| `9:16` | `720x1280` |
| `1:1` | `960x960` |
## Flux de tâche
Créez la tâche via cet endpoint et enregistrez l’id de tâche Kling renvoyé.
Vérifiez la progression via [Obtenir une tâche Kling](./individual-queries) jusqu’à ce que la tâche atteigne un état terminal.
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 variantes de modèle, consultez la [documentation officielle de Kling](https://kling.ai/document-api/apiReference/model/textToVideo).
## OpenAPI
````yaml api/openapi/video/kling/post-text-to-video.openapi.json POST /kling/v1/videos/text2video
openapi: 3.1.0
info:
title: Text to Video API
version: 1.0.0
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/kling/v1/videos/text2video:
post:
summary: Text to Video
operationId: text_to_video
parameters:
- name: Content-Type
in: header
required: false
description: Must be `application/json`.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- prompt
properties:
prompt:
type: string
description: >-
Text prompt describing the video to generate. Maximum 500
characters.
negative_prompt:
type: string
description: Elements to exclude from the video. Maximum 200 characters.
aspect_ratio:
type: string
description: >-
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.
enum:
- '16:9'
- '9:16'
- '1:1'
callback_url:
type: string
description: >-
Webhook URL to receive task status updates when the task
completes.
model_name:
type: string
description: >-
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.
enum:
- kling-v1
- kling-v1-6
- kling-v2-master
- kling-v2-1-master
- kling-v2-5-turbo
- kling-v2-6
- kling-v3
default: kling-v1
cfg_scale:
type: number
description: >-
Prompt adherence strength. Higher values follow the prompt
more closely. Range: 0–1.
mode:
type: string
description: >-
Generation mode. `std` for standard (faster), `pro` for
professional (higher quality). The default is `std`.
enum:
- std
- pro
default: std
duration:
type: string
description: >-
Output video length in seconds. Use `5` or `10`; omit to use
`5`.
default: '5'
camera_control:
type: object
description: >-
Camera motion preset or manual configuration. Omit for
automatic camera movement.
properties:
type:
type: string
description: Preset camera motion type.
enum:
- simple
- down_back
- forward_up
- right_turn_forward
- left_turn_forward
config:
type: object
description: >-
Manual camera movement axes. Each value ranges from -10
to 10.
properties:
horizontal:
type: integer
description: >-
Horizontal dolly (truck). Negative = left, positive
= right. Range: -10 to 10.
vertical:
type: integer
description: >-
Vertical dolly (pedestal). Negative = down, positive
= up. Range: -10 to 10.
pan:
type: integer
description: >-
Horizontal rotation (pan). Negative = left, positive
= right. Range: -10 to 10.
tilt:
type: integer
description: >-
Vertical rotation (tilt). Negative = down, positive
= up. Range: -10 to 10.
roll:
type: integer
description: >-
Axial rotation (roll). Negative = counter-clockwise,
positive = clockwise. Range: -10 to 10.
zoom:
type: integer
description: >-
Zoom. Negative = zoom out, positive = zoom in.
Range: -10 to 10.
external_task_id:
type: string
description: >-
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.
sound:
type: string
description: >-
Optional generated-audio switch for models that support
video sound. Use `on` or `off`, or omit the field for the
model default.
enum:
- 'on'
- 'off'
default:
prompt: >-
A small ceramic cup on a wooden table, steam rising in soft
morning light
model_name: kling-v3
mode: std
duration: '5'
sound: 'off'
examples:
Default:
summary: Kling V3 text-to-video request with generated sound disabled
value:
prompt: >-
A small ceramic cup on a wooden table, steam rising in soft
morning light
model_name: kling-v3
mode: std
duration: '5'
sound: 'off'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: Error code; specifically define the error code
message:
type: string
description: error message
request_id:
type: string
description: >-
Request ID, system-generated, for tracking requests,
troubleshooting issues
data:
type: object
properties:
task_id:
type: string
description: Task ID, system generated
task_status:
type: string
description: >-
Task status, enumerated values: submitted, processing,
succeed, failed.
created_at:
type: integer
description: Task creation time, Unix timestamp, in ms.
updated_at:
type: integer
description: Task update time, Unix timestamp, in ms.
x-codeSamples:
- lang: Shell
label: Default
source: |
curl https://api.cometapi.com/kling/v1/videos/text2video \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
"model_name": "kling-v3",
"mode": "std",
"duration": "5",
"sound": "off"
}'
- lang: Python
label: Default
source: |
import os
import requests
response = requests.post(
"https://api.cometapi.com/kling/v1/videos/text2video",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
"model_name": "kling-v3",
"mode": "std",
"duration": "5",
"sound": "off"
},
)
result = response.json()
print(result.get("code"), result.get("data", {}).get("task_id"))
- lang: JavaScript
label: Default
source: >
const response = await
fetch("https://api.cometapi.com/kling/v1/videos/text2video", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
"model_name": "kling-v3",
"mode": "std",
"duration": "5",
"sound": "off"
}),
});
const result = await response.json();
console.log(result.code, result.data?.task_id);
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````