Kuaishou
Kling 2.5
kling-2.5-turbo/text-to-video
Modèle image-vers-vidéo lancé par Kuaishou, remarquable par la fluidité du mouvement et la cohérence des personnages, prenant en charge les prompts négatifs et le réglage CFG, adapté à la génération de courts métrages à plans très dynamiques
Essayer kling-2.5-turbo/text-to-video
Entrée
Créations
Voir toutes les créationsSortie
videoTarifs
kling-2.5-turbo/text-to-video per second
| Prix unitaire | $0.060 |
|---|
Présentation
La voie texte-vers-vidéo de Kling 2.5 Turbo s'adresse aux développeurs qui ont besoin de générer directement de courtes vidéos à partir de texte. Il suffit de saisir un prompt pour produire des séquences cinématographiques de 10 secondes maximum, en format paysage, portrait ou carré, avec prise en charge des prompts négatifs et du réglage CFG pour orienter le rendu. Cet outil convient à la production rapide de spots publicitaires, de prévisualisations cinématographiques et de contenus pour les réseaux sociaux, et offre de bonnes performances sur les scènes à forte dynamique d'action et de mouvement de caméra.
Points clés
- Respect du prompt réglable et quantifiable — cfg_scale se règle entre 0 et 1 pour ajuster le degré de fidélité de la vidéo à la description textuelle, afin de trouver l'équilibre entre liberté créative et restitution précise.
- Prompt négatif pour exclure les éléments indésirables — prise en charge d'un negative_prompt de 2500 caractères maximum, décrivant explicitement les contenus à éviter, ce qui réduit les régénérations de séquences ratées.
- Trois formats adaptés à plusieurs canaux de diffusion — aspect_ratio propose 16:9, 9:16 et 1:1 : une seule intégration couvre ainsi les contenus paysage, portrait et carré.
- Deux durées disponibles : 5 et 10 secondes — duration peut être fixé à 5 ou 10 secondes pour contrôler la longueur du clip selon le besoin, adapté aux courts-métrages et aux plans de storyboard.
Capacités
Génération directe de vidéo à partir de texte : il suffit de fournir un prompt décrivant le sujet, l'action, la scène et le mouvement de caméra pour générer une vidéo, avec un maximum de 2500 caractères, idéal pour produire en série des plans à partir de langage naturel.
Contrôle par prompt négatif et CFG : le negative_prompt permet d'exclure les éléments non désirés, et cfg_scale ajuste l'intensité du respect du prompt, ce qui réduit les générations répétées et améliore le taux d'utilisabilité dès la première génération.
Format et durée au choix : sélectionnez le format 16:9, 9:16 ou 1:1 selon le canal de publication, et spécifiez une durée de 5 ou 10 secondes pour que la sortie corresponde directement aux exigences du canal de diffusion.
Cas d'usage
- Équipes publicitaires et de marque : transformer les arguments produit en courts-métrages — saisissez une description produit et un prompt de mouvement de caméra pour produire un clip de marque de 5 ou 10 secondes, destiné aux diffusions in-feed et aux publications sur les réseaux sociaux.
- Équipes de préproduction cinématographique : générer des prévisualisations de fragments de scénario — convertissez des descriptions de scènes en extraits conceptuels animés, servant de storyboard et de prévisualisation visuelle pour aider le réalisateur et le chef opérateur à valider le rythme des plans.
- Gestion de réseaux sociaux : production en série de vidéos verticales — choisissez le format 9:16 et une durée courte pour générer en série des contenus verticaux à partir de textes de sujets éditoriaux, destinés à la mise à jour quotidienne des plateformes de vidéos courtes.
- Créateurs de contenus d'action et de sport : génération de plans à forte dynamique — décrivez par prompt des mouvements complexes comme le sport ou la danse pour générer des extraits au mouvement fluide, destinés à la production de contenus sportifs ou de danse.
Limites et conseils de choix
La durée maximale de génération par requête est de 10 secondes, ce qui ne convient pas à la production directe de vidéos longues : un assemblage en post-production ou une génération par segments est nécessaire. La qualité du résultat dépend fortement de la rédaction du prompt et de l'optimisation des paramètres tels que cfg_scale et le prompt négatif ; lors d'une première utilisation, il est conseillé de lancer d'abord de petits lots d'essai pour déterminer les paramètres. Cette voie n'accepte que l'entrée textuelle ; si vous disposez déjà d'images de référence et souhaitez préserver la cohérence visuelle, privilégiez la voie image-vers-vidéo de la même famille. Pour les projets nécessitant une narration en plan-séquence ou une continuité stricte du storyboard, il convient d'évaluer le coût de raccord après génération par segments.
Nouveautés
Voir le journal des modifications →- Nouveau modèle Ajout de la documentation kling-2.5-turbo/text-to-video
- Nouveau modèle Nouvelle documentation des modèles vidéo : kling-2.5-turbo/image-to-video ( piloté par la première image, 5 secondes fixes en 1080p, en option…
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe 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-KeystringOptionnelClé 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.
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
modelstringRequisValeur fixe actuelle : kling-2.5-turbo/text-to-video
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour kling-2.5-turbo/text-to-video et la route default — voir le tableau des paramètres ci-dessous.
promptstringRequisminLength 1maxLength 2500Invite de description du sujet, des actions, de la scène et des mouvements de caméra de la vidéo, sur la base de laquelle le modèle génère le contenu visuel correspondant.
durationintegerOptionnelDéfaut: 5min 5max 10Durée de génération de la vidéo, en secondes ; 5 secondes par défaut.
510cfg_scalenumberOptionnelDéfaut: 0.5min 0max 1Intensité de respect de l'invite, contrôlant le degré de correspondance entre l'image vidéo et la description textuelle ; 0,5 par défaut.
aspect_ratiostringOptionnelDéfaut: "16:9"Format d'image, déterminant la génération d'une image paysage, portrait ou carrée, à choisir selon le canal de publication ; 16:9 par défaut.
16:99:161:1negative_promptstringOptionnelmaxLength 2500Invite négative, servant à décrire les éléments que l'on ne souhaite pas voir apparaître dans la vidéo générée, que le modèle s'efforcera d'éviter.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
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.
urlstringRequisObligatoire 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.
finalstoragestringOptionnelDé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.
temppersistentExemples 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-2.5-turbo/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"cfg_scale": 0.5,
"aspect_ratio": "16:9"
}
}' 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-2.5-turbo/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"cfg_scale": 0.5,
"aspect_ratio": "16:9"
}
}),
});
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-2.5-turbo/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"cfg_scale": 0.5,
"aspect_ratio": "16:9"
}
},
)
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
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom 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.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
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.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes 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
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription 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"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
Modèles associés
Voir tous les modèles →Même type
-
Grok Imagine 1.5 xAI $0.011 /seconde -
Vidu Q3 Vidu $0.149 /seconde -
MiniMax H3 MiniMax $0.072 /seconde -
Kling 3.0 Turbo Kuaishou $0.130 /seconde -
PixVerse V6 PixVerse $0.036 /seconde -
HappyHorse 1.0 Alibaba $0.168 /seconde -
Gemini Omni 1.1 Flash Google $0.450 /vidéo -
Grok Imagine 1.5 Lite xAI $0.029 /seconde -
FLUX 3 Max Black Forest Labs $0.061 /seconde -
Seedance 2.0 ByteDance $0.017 /seconde -
Wan 3.0 Video Alibaba $0.040 /seconde -
HeyGen Avatar IV HeyGen $0.150 /seconde