Comment utiliser l'API Kling 3.0 Omni ? Quatre points d'entrée opérationnels en 5 minutes

TL;DR

• Kling 3.0 Omni est le modèle vidéo tout-en-un de Kuaishou ; sur HiAPI, il se divise en quatre points d'entrée : texte-vers-vidéo, image-vers-vidéo, référence-vers-vidéo et réécriture vidéo. Ouvrez la page du modèle pour générer en ligne ; les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.
• Facturation à la seconde : à partir de $0.10/seconde en 720p, $0.129/seconde en 1080p, $0.479/seconde en 4K ; l'activation du son et la présence d'une vidéo de référence ont des tarifs distincts.
• L'API utilise toujours la même interface /v1/tasks, seuls model et input changent. Les exemples curl et Python ci-dessous sont prêts à exécuter.

Que fait chacun des quatre points d'entrée ?

ID du modèle	Entrée	Idéal pour
kling-3.0-omni/text-to-video	Prompt	Créer un plan à partir de zéro
kling-3.0-omni/image-to-video	1 image de première frame, ou première frame + dernière frame	Faire bouger une image
kling-3.0-omni/reference-to-video	1 à 7 images de référence, avec éventuellement 1 vidéo de référence	Verrouiller un personnage, un produit, ou reproduire un mouvement de caméra de référence
kling-3.0-omni/transformation	1 vidéo source	Conserver le mouvement de caméra et l'action, changer de scène et de style

Les quatre points d'entrée permettent de choisir la résolution 720p, 1080p ou 4k. Le texte-vers-vidéo et la référence-vers-vidéo permettent de définir la durée (3 à 15 secondes), le format d'image (16:9, 9:16, 1:1) et le son (audio) ; l'image-vers-vidéo permet de définir la durée et le son, le format d'image suivant la première frame ; la réécriture vidéo ne transmet que le prompt, la vidéo source et la résolution, la durée et le format d'image suivant la vidéo source, sans générer de son. Le texte-vers-vidéo, l'image-vers-vidéo et la référence-vers-vidéo prennent également en charge les plans multiples intelligents (prefer_multi_shots), et les quatre points d'entrée acceptent des sujets réutilisables (elements, en écrivant @nom dans le prompt).

Le bateau en papier de 3 secondes en 720p ci-dessous, sous la pluie nocturne, a été généré directement à partir d'un seul prompt :

A paper boat drifts down a rain-soaked city gutter at dusk, neon signs reflecting and rippling on the water; the camera glides low beside it as raindrops splash around. Cinematic, shallow depth of field, smooth tracking motion.

Générer avec ce prompt →

Deux parcours de prise en main

Essai en ligne (sans code)

1. Ouvrez la page du modèle correspondant (par exemple texte-vers-vidéo), inscrivez-vous ou connectez-vous.
2. Collez le prompt, choisissez la durée, la résolution, le format d'image et activez le son si besoin.
3. Cliquez sur générer, puis téléchargez directement la vidéo une fois produite.

Appel API

1. Créez une API Key dans la console.
2. POST https://api.hiapi.ai/v1/tasks pour soumettre, renvoie un taskId.
3. GET /v1/tasks/{taskId} pour vérifier l'état ; lorsque status vaut success, téléchargez depuis output[0].url.

curl : texte-vers-vidéo

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni/text-to-video",
    "input": {
      "prompt": "A paper boat drifts down a rain-soaked city gutter at dusk, neon signs reflecting on the water.",
      "duration": 5,
      "resolution": "720p",
      "audio": false,
      "aspect_ratio": "16:9"
    }
  }'

Python : soumission, polling, téléchargement

import os, time, requests

H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, **inp):
    r = requests.post("https://api.hiapi.ai/v1/tasks",
                      json={"model": model, "input": inp}, headers=H)
    task_id = r.json()["data"]["taskId"]
    while True:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(10)

url = generate(
    "kling-3.0-omni/image-to-video",
    prompt="Morning fog slowly lifts over the harbor, camera slowly pushes in along the dock.",
    image_urls=["https://your-cdn.example.com/harbor.jpg"],
    duration=5, resolution="720p",
)
open("clip.mp4", "wb").write(requests.get(url).content)

Comment rédiger les trois autres points d'entrée ?

Image-vers-vidéo : image_urls avec 1 image correspond à la première frame, avec 2 images à la première frame plus la dernière frame ; le format d'image de sortie suit la première frame.

Morning fog slowly lifts over the harbor as the fishing boats rock gently on the water; the low sun breaks through the haze and glints on the wet pier, camera slowly pushes in along the dock. Cinematic, calm, photorealistic.

Générer avec ce prompt →

Référence-vers-vidéo : image_urls est obligatoire (1 à 7 images, JPG/PNG, 50 Mo maximum par image, côté le plus court d'au moins 300 px), avec éventuellement 1 video_urls comme référence de mouvement de caméra (MP4/MOV, 3 à 15,5 secondes, 200 Mo maximum). L'exemple ci-dessous utilise l'image de première frame du bateau en papier comme référence de sujet, et la vidéo de nuit sous la pluie ci-dessus comme référence de mouvement de caméra ; le bateau en papier est transposé dans un ruisseau forestier :

The same white paper boat from the reference drifts along a sunlit forest stream at golden hour, leaves floating beside it, camera tracks low alongside it with the same smooth motion as the reference video. Cinematic, shallow depth of field.

Générer avec ce prompt →

Avec une vidéo de référence, audio doit être false, les plans multiples intelligents ne sont pas disponibles et le nombre d'images de référence est limité à 4. Requête minimale :

{
  "model": "kling-3.0-omni/reference-to-video",
  "input": {
    "prompt": "The same white paper boat from the reference drifts along a forest stream",
    "image_urls": ["https://static.hiapi.ai/admin-assets/2026/10/13/1791861888668-6554d6167af93003-kling-omni-boat-frame.jpg"],
    "video_urls": ["https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"],
    "duration": 3,
    "resolution": "720p",
    "audio": false
  }
}

Pour verrouiller plusieurs sujets, nommez chaque sujet avec elements et écrivez @nom dans le prompt ; la syntaxe complète est décrite dans les exemples de prompts pour la référence-vers-vidéo.

Réécriture vidéo : video_urls transmet 1 vidéo source (MP4/MOV, 3 à 15,5 secondes, 200 Mo maximum), et le prompt décrit ce en quoi il faut la transformer. La durée et le format d'image de sortie suivent la vidéo source, et aucun son n'est généré. Requête minimale :

{
  "model": "kling-3.0-omni/transformation",
  "input": {
    "prompt": "Transform the scene into a snowy winter night, keep the exact camera motion",
    "video_urls": ["https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"],
    "resolution": "720p"
  }
}

La même scène de bateau en papier sous la pluie nocturne, transformée en bateau-lanterne en papier lumineux par une nuit de neige :

Transform the scene into a snowy winter night: the gutter becomes a frozen stream with drifting snowflakes, the paper boat becomes a small glowing paper lantern boat, keep the exact camera motion and water movement from the original video. Cinematic, cold blue tones.

Générer avec ce prompt →

Combien ça coûte ?

Point d'entrée	720p	1080p	4K
Texte / Image-vers-vidéo, son désactivé	$0.10/seconde	$0.129/seconde	$0.479/seconde
Texte / Image-vers-vidéo, son activé	$0.129/seconde	$0.1645/seconde	$0.479/seconde
Référence-vers-vidéo, sans vidéo de référence	Idem	Idem	Idem
Référence-vers-vidéo, avec vidéo de référence	$0.143/seconde	$0.193/seconde	$0.479/seconde
Réécriture vidéo	$0.143/seconde	$0.193/seconde	$0.479/seconde

Une vidéo texte-vers-vidéo de 5 secondes en 720p avec son désactivé coûte $0.50 ; avec $10, vous pouvez générer 100 secondes ; la plus courte, 3 secondes, coûte seulement $0.30. Pour ajuster le prompt, commencez par du 720p et 3 à 5 secondes, puis passez en 1080p ou 4K une fois finalisé. Les tâches échouées sont automatiquement remboursées.

Points d'attention avant mise en production

• Utilisez un callback au lieu du polling : ajoutez au niveau supérieur de la requête "callback": {"url": "https://votre-domaine/hiapi/callback"} ; HiAPI notifie activement en cas de succès ou d'échec, dédupliquez par taskId.
• Les vidéos sont conservées environ 7 jours par défaut : après avoir obtenu output[0].url, transférez-les ; pour une conservation à long terme, utilisez le stockage persistant de HiAPI (facturé séparément selon le volume stocké).
• Renseignez tous les paramètres selon le point d'entrée : indiquez explicitement resolution, duration, audio pour le texte-vers-vidéo, l'image-vers-vidéo et la référence-vers-vidéo ; pour la réécriture vidéo, indiquez uniquement resolution, la durée suivant la vidéo source.
• Les noms d'éléments ne contiennent pas d'espaces : écrivez serum dans elements[].name et @serum dans le prompt.

Questions fréquentes

Faut-il activer les quatre points d'entrée séparément ?

Non. La même API Key suffit, il suffit de changer model.

Peut-on générer en format portrait ?

Oui. Écrivez 9:16 dans aspect_ratio pour le texte-vers-vidéo et la référence-vers-vidéo ; l'image-vers-vidéo suit le ratio de la première frame, la réécriture vidéo suit la vidéo source.

Comment ajouter du son ?

Pour le texte-vers-vidéo, l'image-vers-vidéo et la référence-vers-vidéo (sans vidéo de référence), réglez audio sur true pour générer des sons d'ambiance et des effets sonores synchronisés avec l'image. Le coût augmente de $0.029 par seconde en 720p et de $0.0355 par seconde en 1080p.

Peut-on écrire le prompt en chinois ?

Oui. Pour un résultat plus stable, décrivez clairement en phrases séparées le mouvement de caméra, l'action du sujet, la lumière et le style.

Copiez le prompt du bateau en papier sous la pluie nocturne ci-dessus, allez sur la page du modèle pour générer votre première vidéo ; pour davantage d'exemples copiables, consultez les exemples de prompts Kling 3.0 Omni, et pour les détails tarifaires, les tarifs de l'API Kling 3.0.