Kuaishou

Kling 3.0

kling-3.0-omni/reference-to-video

Série unifiée de génération vidéo multimodale, prenant en charge la génération de vidéo à partir de texte, d'image, de référence, ainsi que l'édition au sein de la vidéo, avec synchronisation labiale native et audio multilingue

kling-3.0-omni/image-to-video kling-3.0-omni/reference-to-video kling-3.0-omni/text-to-video kling-3.0-omni/transformation kling-3.0/image-to-video kling-3.0/motion-control kling-3.0/text-to-video

Essayer kling-3.0-omni/reference-to-video

Entrée

Subjects

Créations

Voir toutes les créations

Sortie

video

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

Tarifs

kling-3.0-omni/reference-to-video per second

Spécifications	720P	1080P	4K
Sound Off · Without Reference Videos	$0.100	$0.129	$0.479
Sound On · Without Reference Videos	$0.129	$0.1645	$0.479
Sound Off · With Reference Videos	$0.143	$0.193	$0.479
Sound On · With Reference Videos	$0.143	$0.193	$0.479

Aperçu du positionnement

kling-3.0-omni/reference-to-video est le circuit de la série Kling 3.0 Omni dédié à la génération de vidéos à partir d'images de référence. Il permet d'utiliser de 1 à 7 images de référence (ou jusqu'à 7 éléments de sujet réutilisables) comme ancrage visuel, associées à une invite textuelle, pour générer des vidéos de 3 à 15 secondes. Prend en charge les résolutions 720p, 1080p et 4k ainsi que les formats 16:9, 9:16 et 1:1, avec possibilité d'activer l'audio natif et le multi-plan intelligent. Adapté aux développeurs qui doivent maintenir la cohérence d'un personnage ou d'un objet entre les plans et produire en série des vidéos marketing et pour les réseaux sociaux.

Points clés

Double ancrage : images de référence et éléments de sujet — possibilité de fournir de 1 à 7 images de référence, ou de définir jusqu'à 7 éléments de sujet contenant chacun de 2 à 4 images et de les invoquer par @name dans l'invite.
Vidéo de référence en option — possibilité d'ajouter 1 vidéo de référence de 3 à 15,5 secondes pour contraindre le mouvement et la composition ; dans ce cas, la limite totale des images de référence et des éléments de sujet est ramenée à 4.
Résolutions et formats du portrait au 4K — sortie au choix en 720p, 1080p ou 4k, formats 16:9, 9:16 et 1:1, adaptés à la diffusion paysage comme aux vidéos courtes verticales.
Audio natif et multi-plan combinables — l'audio natif (désactivé par défaut) et le multi-plan intelligent peuvent être activés simultanément pour générer en une fois un extrait multi-plan avec son ; ils ne sont pas disponibles lorsque qu'une vidéo de référence est utilisée.

Description des capacités

Génération cohérente multi-sujets : définir via elements le nom, la description et de 2 à 4 images d'un même sujet, puis les invoquer par @name dans l'invite afin qu'un même personnage ou objet conserve une apparence cohérente sur plusieurs plans.

Contrainte par vidéo de référence : fournir 1 vidéo de référence MP4/MOV (200 Mo maximum, 3 à 15,5 secondes) pour guider le mouvement et le rythme, idéal pour une génération stylisée ou de type remake à partir de supports existants.

Contrôle de la résolution et du format : choisir une sortie 720p, 1080p ou 4k selon le canal de diffusion et définir un format 16:9, 9:16 ou 1:1 pour limiter le recadrage et le transcodage en post-production.

Audio natif et multi-plan intelligent : activer audio génère le son en même temps, activer prefer_multi_shots laisse le modèle découper automatiquement les plans selon l'invite ; les deux sont disponibles tant qu'aucune vidéo de référence n'est utilisée.

Durée et longueur d'invite ajustables : la durée de sortie de 3 à 15 secondes se règle selon le besoin narratif, et l'invite peut atteindre 3072 caractères, de quoi décrire le sujet, l'action et la mise en scène des plans.

Cas d'usage

Équipes marketing de marque : images de référence + arguments produit — verrouiller l'apparence à partir d'images de référence multi-angles d'un produit et produire un film court avec format et résolution spécifiés, directement exploitable dans les flux d'actualité et sur le site officiel.
Gestion de réseaux sociaux : éléments de personnage + script vertical — définir un élément de personnage fixe puis générer en série des vidéos courtes 9:16 en conservant la cohérence du personnage, pour une production de contenu quotidienne.
Préproduction cinéma et animation : vidéo de référence + invite de storyboard — utiliser une vidéo de référence pour contraindre le rythme du mouvement et produire des extraits de prévisualisation multi-plans, afin que le réalisateur valide la conception des plans et les points de montage.
Équipes de contenu e-commerce : galerie produit transformée en vidéo — téléverser des images de référence produit et définir un format 1:1 ou 16:9 pour générer une vidéo de présentation destinée aux pages de détail et aux emplacements d'image principale du produit.

Limites et conseils de choix

Le total des images de référence et des éléments de sujet ne doit pas dépasser 7, ramené à 4 en cas d'ajout d'une vidéo de référence ; dans ce cas, l'audio natif et le multi-plan intelligent ne sont pas disponibles. La durée d'une génération est limitée à 15 secondes ; une narration longue nécessite une génération par segments puis un assemblage. Les images de référence doivent être en JPG/PNG, ne pas dépasser 50 Mo par image et avoir un petit côté d'au moins 300 px ; la vidéo de référence doit être en MP4/MOV et durer de 3 à 15,5 secondes. Si seul un pilotage par image unique ou une génération purement textuelle est requis, on peut opter pour les circuits image-to-video ou text-to-video de la même série ; pour des exigences spécifiques de contrôle du mouvement, on pourra évaluer motion-control.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveau modèle : Kling 3.0 Omni (可灵 O3), appelé via POST /v1/tasks. kling-3.0-omn… Oct 12, 2026

Questions fréquentes

Voir toutes les questions →

Kling 3.0 Image-to-Video nécessite-t-il de téléverser une image ?

Oui. Actuellement, kling-3.0/image-to-video est une voie de génération de vidéo à partir d'image : l'image d'entrée définit le sujet et la composition initiale, tandis que le Prompt gère les actions, les mouvements de caméra et les changements d'environnement.
Quelles durées et résolutions Kling 3.0 Image-to-Video prend-il en charge ?

Le contrat de requête actuel de HiAPI prend en charge 3–15s, avec des résolutions de sortie de 720p, 1080p et 4K. Les valeurs disponibles sont celles indiquées dans le panneau de paramètres de la page et la documentation API.
Comment la fonctionnalité Image-to-Video de Kling 3.0 est-elle facturée ?

Les tâches sont facturées en fonction de la durée de sortie et du palier choisi. La page affiche le prix en temps réel selon l'unité monétaire globale, et la facturation finale se base sur l'enregistrement des tâches réussies.
Comment améliorer la stabilité du sujet dans la génération de vidéo à partir d'une image ?

Utilisez une image d'entrée dont le sujet est net, peu masqué et bien composé ; dans le Prompt, décrivez d'abord l'action principale et le cadrage, puis énumérez les éléments d'apparence, de matière et les relations avec l'arrière-plan qui doivent être préservés. Pour un premier test, il est recommandé d'utiliser une durée courte.

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-3.0-omni/reference-to-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

audiobooleanOptionnelDéfaut: false

Indique si une piste audio native synchronisée avec l'image doit être générée en même temps que la vidéo ; valeur booléenne, false par défaut ; non disponible lorsqu'une vidéo de référence (video_urls) est fournie.

promptstringRequisminLength 1maxLength 3072

Décrit le contenu vidéo souhaité ; pour utiliser un sujet des elements, il est possible de référencer son nom sous la forme @name dans le prompt.

durationintegerOptionnelDéfaut: 5min 3max 15

Durée de la vidéo de sortie, en secondes, entier, plage de valeurs 3-15, 5 par défaut.

elementsarrayOptionnelmaxItems 7

Liste de sujets réutilisables, 7 au maximum ; chaque élément contient un nom, une brève description et 2 à 4 images, et peut être référencé sous la forme @name dans le prompt.

Array [ object ]

Éléments du tableau

namestringRequisminLength 1

Nom unique du sujet, utilisé pour le référencer sous la forme @name dans le prompt ; le nom ne doit pas contenir d'espaces.

descriptionstringRequisminLength 1

Texte de description brève du sujet, servant à aider le modèle à identifier et à restituer ce sujet.

element_input_urlsarrayRequisminItems 2maxItems 4

Tableau d'images de référence du même sujet, 2 à 4 images requises, formats JPG/PNG pris en charge.

Array [ string ]

image_urlsarrayRequisminItems 1maxItems 7

Tableau d'images de référence, 1 à 7 images possibles ; si une vidéo de référence est ajoutée, 4 images au maximum, et le total des images de référence et des sujets (elements) ne doit pas dépasser 7 (total ne dépassant pas 4 en cas d'inclusion d'une vidéo de référence). Formats JPG/PNG pris en charge, 50 Mo maximum par image, côté d'au moins 300 px.

Array [ string ]

resolutionstringOptionnelDéfaut: "720p"

Résolution de la vidéo de sortie, chaîne de caractères, 720p par défaut.

Options：720p1080p4k

video_urlsarrayOptionnelminItems 1maxItems 1

Tableau facultatif de vidéos de référence, formats MP4 ou MOV pris en charge, 200 Mo maximum par vidéo, durée de 3 à 15,5 secondes, largeur et hauteur de 700 à 4553 px, fréquence d'images de 24 à 60 fps ; après ajout d'une vidéo de référence, l'audio natif et le multi-plan intelligent ne sont pas pris en charge.

Array [ string ]

aspect_ratiostringOptionnelDéfaut: "16:9"

Rapport largeur/hauteur de la vidéo de sortie, chaîne de caractères, 16:9 par défaut.

Options：16:99:161:1

prefer_multi_shotsbooleanOptionnelDéfaut: false

Indique si le modèle doit planifier automatiquement plusieurs plans en fonction du prompt ; valeur booléenne, false par défaut ; non disponible après ajout d'une vidéo de référence.

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-3.0-omni/reference-to-video",
  "input": {
    "audio": false,
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "prefer_multi_shots": false
  }
}'

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-3.0-omni/reference-to-video",
    input: {
      "audio": false,
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "prefer_multi_shots": false
    }
  }),
});
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-3.0-omni/reference-to-video",
        "input": {
          "audio": False,
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "prefer_multi_shots": False
        }
    },
)
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"
    }
  }
}