Créer une vidéo

Créez des tâches Kling 4.0 à partir de texte, d’images ou avec Omni au format plateforme.

Utilisez les champs communs pour les entrées simples et metadata.contents pour les entrées avancées. Placez les réglages dans metadata.settings, les rappels et filigranes dans metadata.options.

POST/v1/video/generations

Créez avec les champs plateforme et metadata pour le texte, l’image ou Omni. L’alias POST /v1/videos/generations accepte les mêmes paramètres. Tous utilisent kling-4.0 ; Omni désigne la référence multiple, pas un autre modèle.

Authentification

bearerAuth

AuthentificationBearer <token>

API Key plateforme : Authorization: Bearer your-api-key.

Emplacement: header

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

Fournissez prompt et ressources via prompt ou metadata.contents selon l’opération, sans placer les champs natifs au premier niveau plateforme.

model*"kling-4.0"

Toutes les opérations utilisent Kling 4.0.

Valeur par défaut"kling-4.0"

Valeurs autorisées

"kling-4.0"

prompt?Prompt

Descriptions positives et négatives dans le prompt. Anglais seul : maximum 26000 caractères ; autres langues seules : 11000. Mélange : E/26000 + N/11000 <= 1 ; E compte les caractères anglais, N les autres.

image?string

URL d’une image unique, raccourci image vers vidéo.

images?array<string>

Une image : début ; deux : début/fin. Images supplémentaires via metadata.contents typé.

duration?integer

Durée en secondes en raccourci. metadata.settings explicite prioritaire.

Plage3 <= value <= 30

seconds?integer

Raccourci de durée plateforme ; n’utiliser qu’une représentation. metadata.settings explicite prioritaire.

Plage3 <= value <= 30

size?string

Résolution 720p ou 1080p, pas des dimensions en pixels. Préférez metadata.settings.resolution, sans doubler avec size.

Valeurs autorisées

"720p"
"1080p"

metadata?

Extensions natives. settings explicite prioritaire ; false et 0 conservés, sous réserve des contraintes de l’opération native.

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.cn/v1/video/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0",
    "prompt": "Parc technologique côtier ensoleillé, la caméra tourne lentement autour de bâtiments blancs.",
    "metadata": {
      "operation": "text-to-video",
      "settings": {
        "duration": 3,
        "resolution": "720p"
      },
      "options": {
        "watermark_info": {
          "enabled": false
        }
      }
    }
  }'

{
  "id": "123456789012345678",
  "task_id": "123456789012345678",
  "object": "video",
  "model": "kling-4.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1792732542
}

Résultat de création et consultation

La création renvoie un objet tâche au premier niveau. id et task_id sont des identifiants sous forme de chaînes. Conservez task_id puis utilisez l’API de consultation plateforme pour obtenir l’état et l’URL vidéo.

status: "queued" indique une tâche acceptée et en attente ; progress: 0 n’indique pas un échec. La réponse de création ne contient pas l’URL finale. created_at est un horodatage Unix en secondes, contrairement aux millisecondes des réponses natives.

Choisir les entrées

Scénario	Entrée	Règles détaillées
Texte vers vidéo	`prompt` ; réglages avancés : `metadata.operation: "text-to-video"`	Paramètres texte
Image vers vidéo	`image` / `images` ou `metadata.contents` typé ; opération `image-to-video`	Sources et limites des images clés
Référence ou montage Omni	Utiliser `metadata.operation: "omni-video"` et `metadata.contents`	Types, références et combinaisons

Un metadata.settings explicite prime sur les raccourcis. La référence id est facultative pour les images/vidéos ; id est obligatoire pour les éléments/voix. Les identifiants de référence fournis doivent être uniques dans la tâche.

Erreurs courantes et dépannage

Réponse ou erreur	Vérification et action
HTTP 401, `Invalid token`	Vérifiez `Authorization: Bearer your-api-key` et utilisez une API Key valide pour le site appelé
HTTP 400, `模型名称不能为空`	Renseignez `model: "kling-4.0"`
HTTP 400, `prompt cannot be empty`	Un `prompt` non vide est nécessaire pour le texte ; renseignez `metadata.contents` selon l’opération native pour les entrées avancées
HTTP 400, `duration must be an integer`	Utilisez un entier tel que `3`, pas la chaîne `"3"` ni une décimale
`settings.resolution ... is invalid`	Utilisez `720p` ou `1080p`, pas des dimensions en pixels ; supprimez `size` et privilégiez `metadata.settings.resolution`
HTTP 400, `invalid JSON request body`	Vérifiez guillemets, virgules et parenthèses ; envoyez du JSON valide sans commentaires

HTTP 400 peut renvoyer code/message/data ou un objet error. Pendant la création, code: "fail_to_fetch_task" peut aussi signaler une validation amont échouée. Lisez la cause dans message plutôt que de renvoyer la demande sur la seule base du code métier.

message peut être une chaîne JSON contenant code/message/request_id, et non un objet déjà analysé. Vérifiez le format avant analyse. Conservez l’identifiant de requête pour l’assistance, sans communiquer votre API Key. Les limites sont celles de l’opération native ; les plages des erreurs génériques ne définissent pas les capacités du modèle.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

Résultat de création et consultation

Choisir les entrées

Erreurs courantes et dépannage

`application/json`

`application/json`

`application/json`