Kuaishou

Kling 4.0

kling-4.0/image-to-video

Modèle de génération vidéo de Kuaishou, capable de générer en une seule fois une vidéo de 30 secondes avec audio stéréo, prenant en charge le contrôle par images clés multiples et par images de début et de fin, adapté aux courts métrages marketing et aux prévisualisations de storyboard

kling-4.0/image-to-video kling-4.0/text-to-video

Essayer kling-4.0/image-to-video

Entrée

Sortie

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

kling-4.0/image-to-video per second

Spécifications	Prix unitaire
1080P	$0.330

Présentation

La gamme Kling 4.0 image-vers-vidéo s'adresse aux développeurs qui souhaitent générer une vidéo continue à partir d'une seule image de première frame. Il suffit de fournir une image jpeg ou png et une description du mouvement, du cadrage et de l'ambiance pour obtenir un clip de 3 à 30 secondes, avec prise en charge des résolutions 720p et 1080p et des formats 16:9, 9:16, 1:1 et 21:9, facturés à la seconde de sortie. Elle convient aux storyboards publicitaires, aux vidéos courtes pour les réseaux sociaux et aux prévisualisations narratives, c'est-à-dire aux processus créatifs qui partent d'une image fixe et contrôlent la trajectoire de la caméra.

Points clés

Le point de départ verrouillé par une seule première frame — une image sert de point de départ au plan, et le prompt contrôle le mouvement et la trajectoire de la caméra, ce qui réduit la dérive d'image propre à la génération purement textuelle.
Durée et format ajustables selon le scénario — la durée couvre 3 à 30 secondes, et le format peut être paysage, portrait, carré ou écran large ; à défaut de précision, le ratio de l'image source est conservé.
Résolution à deux niveaux, brouillon et livrable — le 720p sert aux essais rapides, le 1080p aux sorties de niveau livraison ; ce dernier demande un rendu nettement plus long, à basculer selon l'étape.

Description des capacités

Génération vidéo pilotée par la première frame : une image et un prompt suffisent à générer une vidéo ; le prompt décrit le mouvement, le cadrage et l'ambiance, et le modèle prolonge le plan en prenant la première frame comme référence visuelle.

Contrôle de durée de 3 à 30 secondes : le paramètre de durée fixe la longueur du clip ; les clips courts servent à la validation rapide, les longs évitent les générations multiples suivies d'un assemblage, et la facturation se fait à la seconde de sortie.

Résolution et format au choix : deux niveaux de sortie, 720p et 1080p, et des formats 16:9, 9:16, 1:1 et 21:9 ; si aucun n'est renseigné, le ratio de l'image source est repris, ce qui facilite l'adaptation à différents emplacements de diffusion en une seule fois.

Prompt d'orientation sonore : le champ prompt peut aussi décrire le son souhaité, ce qui permet d'exprimer le mouvement de l'image et l'intention sonore dans le même appel.

Cas d'usage

Storyboard publicitaire : prolonger un plan à partir d'une image produit fixe — fournir une image produit et une description de mouvement de caméra pour produire un clip animé de quelques secondes à plusieurs dizaines de secondes, destiné aux supports de diffusion ou à la prévisualisation du storyboard.
Vidéo courte pour les réseaux sociaux : animer une composition verticale — générer un court clip au format 9:16 à partir d'une seule composition, directement publiable en contenu vertical.
Prévisualisation narrative : faire avancer l'intrigue à partir d'images clés — générer des séquences à partir de la première frame d'une scène, accompagnée d'une description du mouvement et de l'émotion, pour valider à faible coût le rythme des plans et l'enchaînement narratif.
Plans d'ambiance en écran large — générer au format 21:9 un long plan d'ambiance à partir d'une image fixe, pour un générique d'ouverture, une transition ou un arrière-plan.

Limites et conseils de choix

Seule une image de première frame est acceptée en entrée ; aucune prise en charge des sources de référence multiples, des séquences d'images clés ou du contrôle première/dernière frame. La durée maximale par génération est de 30 secondes et la résolution se limite à 720p et 1080p. Le rendu 1080p étant nettement plus long, il est conseillé de valider d'abord le cadrage et la direction du mouvement en 720p avant de livrer le rendu final. Pour générer une vidéo à partir de texte seul, il faut choisir la gamme texte-vers-vidéo de la même série ; pour une narration longue nécessitant un enchaînement précis de plusieurs plans, il convient de générer par segments puis de monter et combiner.

Questions fréquentes

Voir toutes les questions →

Quelles sont les exigences pour l'image de première frame ?

Une URL accessible publiquement vers une image jpeg ou png, placée dans le tableau image_urls, une seule image à la fois. L'image sera utilisée comme image de début du clip.
Que se passe-t-il si je ne sélectionne pas de format d'image ?

Si vous ne transmettez pas aspect_ratio, la sortie suit automatiquement le ratio de la première image ; une image verticale ne sera pas contrainte à être recadrée en paysage. Il n'est nécessaire de le définir explicitement que si vous souhaitez remplacer le ratio de l'image d'origine.
Le prompt est-il obligatoire ?

Oui. L'image de première frame définit la composition et le sujet, tandis que le prompt décrit l'action, le plan et le son ; les deux sont nécessaires. Un texte plus court donne généralement de meilleurs résultats.
Comment la génération de vidéo à partir d'image est-elle facturée ?

Comme pour la génération de vidéo à partir de texte, la facturation se fait à la seconde de sortie, avec des tarifs différents selon le palier 720p ou 1080p, sans prix de départ.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : kling-4.0/image-to-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour kling-4.0/image-to-video et la route default — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 1maxLength 2500

Direction for motion, camera and mood. Required: describe what should move and how, and put the sound you want here too.

durationintegerOptionnelDéfaut: 5min 3max 30

Clip length in seconds (3-30). Billed per second.

image_urlsarrayRequisminItems 1maxItems 1

Image the shot starts from. jpeg or png.

Array [ string ]

resolutionstringOptionnelDéfaut: "720p"

Output resolution. 1080p takes noticeably longer to render than 720p.

Options：720p1080p

aspect_ratiostringOptionnel

Frame shape of the output. Leave empty to follow the source image.

Options：16:99:161:121:9

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-4.0/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "resolution": "720p"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "kling-4.0/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "resolution": "720p"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "kling-4.0/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "resolution": "720p"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}