Génération vidéo Omni

Générez ou modifiez des vidéos Kling 4.0 avec différents types de références.

feature_video reprend les caractéristiques et le rythme d’une vidéo ; base_video sert au montage d’une vidéo existante. Images, vidéos, éléments et voix : maximum 15 ressources au total, avec les limites de chaque type. Les éléments/voix utilisent des ID existants ; les API de gestion des ressources ne sont pas incluses ici.

POST/kling/omni-video/kling-4.0

Combinez prompts, images, vidéos, éléments et voix pour générer ou modifier. feature_video sert de référence, base_video de source de montage. Même modèle Kling 4.0 que les deux autres API de génération.

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.

contents*array<||||>

Prompt et références facultatives ; images, vidéos, éléments et voix : maximum 15 au total, avec limites propres à chaque type.

Éléments1 <= items

settings?

options?

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/omni-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "Reprendre le style de @scene pour une vidéo aérienne côtière."
      },
      {
        "type": "refer_image",
        "id": "scene",
        "url": "https://example.com/scene.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "adaptive"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

Types de ressources et références

contents doit inclure le prompt type: "prompt". Ajoutez les autres ressources au besoin. id sert à @reference dans le prompt ; tous les ID de référence doivent être uniques dans la tâche.

Ressource	`type`	Source et champs obligatoires
Image	`first_frame` / `middle_frame` / `last_frame` / `refer_image`	`url` obligatoire, URL ou Base64 ; `id` facultatif
Vidéo	`feature_video` / `base_video`	`url` obligatoire, URL vidéo ; `id` facultatif
Élément	`element`	`element_id` et `id` obligatoires
Voix	`voice`	`voice_id` et `id` obligatoires

element_id est un ID d’élément système obtenu via les API correspondantes. voice_id est un ID de voix ; utilisez l’API de personnalisation ou les voix prédéfinies officielles. Ces champs diffèrent de la référence id de cette requête.

Voir le guide officiel de la bibliothèque d’éléments et la documentation officielle des voix. Utilisez les ID de la région concernée, sans reprendre ceux d’une autre région.

Limites des ressources

Ressource	Format et taille	Dimensions, durée et nombre
Image	JPG, JPEG, PNG ; maximum 30MB chacune	Largeur/hauteur ≥ 300px ; ratio 2:5～5:2 ; maximum 10
Vidéo	MP4, MOV ; maximum 300MB chacune	Chaque vidéo et total d’entrée : 3～30 secondes ; dimensions 700～4553px, maximum 8294400 pixels ; ratio 2:5～5:2 ; entrée 24～60fps, sortie 24fps
Élément	Multi-images ou personnage vidéo	Maximum 7, dont 3 personnages vidéo
Voix	Voix personnalisée existante ou prédéfinie	Maximum 3

Les combinaisons doivent aussi respecter :

Images, vidéos, éléments et voix : maximum 15 au total.
Vidéos et personnages vidéo : maximum 5 au total ; au plus 1 base_video.
La durée d’entrée inclut feature_video, base_video et les vidéos sources des personnages vidéo.

Erreurs courantes et dépannage

Réponse ou erreur	Vérification et action
HTTP 401, `Invalid token`	Vérifiez le format Bearer et le site de l’API Key
HTTP 400, `contents cannot be empty`	Fournissez un tableau `contents` non vide
HTTP 400, `prompt cannot be empty`	Ajoutez à `contents` un texte `type: "prompt"` non vide
HTTP 400, `contents[0].type ... is invalid`	Vérifiez le type documenté et l’élément à l’index signalé
HTTP 400, `Invalid element id`	Vérifiez `element_id` ; ne le remplacez pas par la référence `id`
HTTP 400, `Invalid voice id`	Vérifiez `voice_id` ; ne le remplacez pas par la référence `id`
HTTP 400, `invalid JSON request body`	Vérifiez guillemets, virgules, parenthèses et commentaires JSON

HTTP 400 peut renvoyer code/message/data ou un objet error. La cause de fail_to_fetch_task figure dans message, éventuellement une chaîne JSON contenant code/message/request_id. Conservez l’identifiant de requête, sans l’API Key.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

Types de ressources et références

Limites des ressources

Erreurs courantes et dépannage

`application/json`

`application/json`

`application/json`