Skip to main content
POST
cURL
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.

Durée et ratio d’aspect

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.

Flux de tâche

1

Soumettre la requête de génération

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

Interroger l’état de la tâche

Vérifiez la progression via Obtenir une tâche Kling 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 variantes de modèle, 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
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
enum<string>

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.

Options disponibles:
16:9,
9:16,
1:1
callback_url
string

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

model_name
enum<string>
défaut:kling-v1

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.

Options disponibles:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

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

mode
enum<string>
défaut:std

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

Options disponibles:
std,
pro
duration
string
défaut:5

Output video length in seconds. Use 5 or 10; omit to use 5.

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.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Options disponibles:
on,
off

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