Créer une vidéo à partir d’une image

Créez une tâche de génération de vidéo à partir d’une image via l’API native Kling.

La requête peut fournir une image de début, une image de fin facultative et des paramètres de génération.

POST/kling/v1/videos/image2video

Utilisez une image initiale et une image finale facultative pour créer une tâche native Kling de génération vidéo à partir d’une image.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Requête native Kling de génération vidéo à partir d’une image.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID de modèle natif Kling, par exemple kling-v2-5-turbo ou kling-v2-6. Les modèles réellement disponibles sont ceux de la liste renvoyée pour la clé API actuelle.

Longueur1 <= length

prompt*string

Prompt positif, limité à 2 500 caractères.

Longueurlength <= 2500

negative_prompt?string

Prompt négatif.

Longueurlength <= 2500

init_image*string

URL de l’image de début pour la génération de vidéo à partir d’une image. Obligatoire pour ce type de génération.

Longueur1 <= length

image_tail?string

URL facultative de l’image de fin. Pour utiliser une image de fin, vous devez définir mode=pro ; avec kling-v2-6, fournir ce champ en mode std renvoie 1201.

mode?string

Mode de génération. Il doit être défini sur pro lorsque vous utilisez image_tail.

Valeurs autorisées

"std"
"pro"

aspect_ratio?string

Format de l’image de sortie.

Valeur par défaut"16:9"

Valeurs autorisées

"16:9"
"9:16"
"1:1"

duration_string?string

Durée de la vidéo, en secondes.

Valeurs autorisées

"5"
"10"

cfg_scale?number

Intensité de la fidélité au prompt.

Plage0 <= value <= 1

sound?string

Indique s’il faut générer du son. Seuls les modèles V2.6 et ultérieurs le prennent en charge.

Valeurs autorisées

"on"
"off"

voice_list?array<>

Liste des voix de référence.

Élémentsitems <= 2

callback?string

URL de callback pour l’état de la tâche.

Formaturi

params?string

Paramètres transmis tels quels au callback.

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.ai/kling/v1/videos/image2video" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Conservez le style du sujet et faites avancer lentement le personnage vers la caméra",
    "negative_prompt": "Flou, faible définition",
    "init_image": "https://example.com/input-image.jpg",
    "image_tail": "https://example.com/end-frame.jpg",
    "mode": "pro",
    "aspect_ratio": "16:9",
    "duration_string": "10",
    "cfg_scale": 0.6,
    "sound": "on",
    "callback": "https://example.com/kling/callback",
    "params": "user_id_123"
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

Créer une vidéo à partir d’une image

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`