Image vers vidéo

Générez une vidéo Kling 4.0 à partir de la première image, des images de début/fin ou de plusieurs images clés.

Combinez prompt et images clés dans contents, au maximum 10 images par tâche. Aucun aspect_ratio n’est proposé ; utilisez des références au ratio souhaité.

POST/kling/image-to-video/kling-4.0

Première image, début/fin ou images clés multiples, maximum 10 images par tâche. Ratio de l’image de référence, sans aspect_ratio.

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<|>

Au moins une image, prompt facultatif. Maximum 10 images clés ; début, milieu et fin ne sont pas tous requis ensemble.

Éléments1 <= items

settings?

options?

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/image-to-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "Animer lentement les vagues de @first, caméra stable."
      },
      {
        "type": "first_frame",
        "id": "first",
        "url": "https://example.com/first.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "720p"
    }
  }'

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

contents accepte first_frame (début), middle_frame (intermédiaire) et last_frame (fin). Le prompt type: "prompt" est facultatif. Les exemples couvrent début, début/fin et images clés multiples.

Élément	Exigence
Source	`url` obligatoire ; URL ou Base64
Format et taille	JPG, JPEG, PNG ; maximum 30MB par image
Dimensions	Largeur/hauteur au moins 300px, ratio 2:5～5:2
Nombre	Maximum 10 images par tâche
ID de référence	`id` facultatif ; unique dans la tâche

Pour désigner une image dans le prompt, attribuez un id ; par exemple "id": "first" correspond à @first. id identifie une référence de cette requête, pas la tâche retournée.

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, `contents must contain at least one of first_frame, middle_frame, last_frame`	Fournissez au moins une image clé ; le prompt seul ne suffit pas
HTTP 400, `must have a non-blank url`	Renseignez un `url` non vide pour l’image clé
HTTP 400, `contents[0].type ... is invalid`	Vérifiez l’index indiqué et utilisez un type image clé ou prompt autorisé
HTTP 400, `invalid_request` ou `invalid JSON request body`	Vérifiez JSON et types ; `contents` doit être un tableau, pas une chaîne

HTTP 400 peut renvoyer code/message/data ou un objet error. fail_to_fetch_task ne signifie pas nécessairement une erreur de consultation ; lisez la validation de ressource dans message, qui peut être une chaîne JSON et non un objet analysé. Conservez l’identifiant de requête, pas l’API Key.

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

Images et références

Erreurs courantes et dépannage

`application/json`

`application/json`

`application/json`