Kuaishou
Kling 4.0
kling-4.0/text-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
Essayer kling-4.0/text-to-video
Entrée
Sortie
Tarifs
kling-4.0/text-to-video per second
| Spécifications | Prix unitaire |
|---|---|
| 1080P | $0.330 |
Présentation du positionnement
La voie texte-vers-vidéo de Kling 4.0 s'adresse aux développeurs qui souhaitent produire directement une vidéo finale à partir d'une simple description textuelle. Il suffit de saisir un prompt décrivant le sujet, l'action, le cadrage et l'éclairage pour obtenir un clip vidéo contenant à la fois l'image et l'audio, avec une durée unique spécifiable entre 3 et 30 secondes, une sortie en 720p ou 1080p, et un choix parmi quatre formats d'image : 16:9, 9:16, 1:1 et 21:9. Idéal pour les équipes réalisant des spots publicitaires courts, des contenus verticaux pour les réseaux sociaux et des prévisualisations de storyboard, via l'interface unifiée de HiAPI.ai, avec une facturation à la seconde de sortie.
Points clés
- Une génération couvrant 3 à 30 secondes — la durée est spécifiée directement comme paramètre de requête ; inutile de découper un long plan en plusieurs segments à recoller, ce qui réduit le travail d'alignement en post-production.
- Image et audio générés ensemble — la scène décrite dans le prompt est produite avec le son, ce qui évite une étape séparée de doublage ou d'effets sonores.
- Quatre formats adaptés aux canaux de diffusion — outre le paysage et le portrait, les formats 1:1 et 21:9 sont également proposés, pour choisir en une fois le ratio de sortie selon l'emplacement sur la plateforme.
- Résolution commutable à la demande — 720p et 1080p sont disponibles ; itérez en basse résolution pendant la phase de brouillon, puis augmentez la netteté une fois le projet finalisé.
Description des capacités
Description de plans par prompt long : le prompt peut contenir jusqu'à 2500 caractères, de quoi décrire intégralement le sujet, l'action, les mouvements de caméra, la lumière et l'ambiance, afin d'exprimer une intention de plan plus complexe en une seule requête.
Contrôle paramétrique de la durée : le paramètre duration prend une valeur de 3 à 30 secondes, avec une facturation à la seconde de sortie ; segments courts et longs plans passent par la même interface, ce qui facilite la répartition des coûts selon le rythme du contenu.
Sortie en deux paliers de résolution : 720p ou 1080p au choix ; le rendu en 1080p prend nettement plus de temps, il est donc préférable de l'exécuter après validation de l'idée créative.
Formats prédéfinis : aspect_ratio prend en charge 16:9, 9:16, 1:1 et 21:9 ; la génération produit directement le ratio cible, sans recadrage secondaire.
Cas d'usage
- Vidéos courtes verticales pour les équipes réseaux sociaux — générez un clip d'environ 15 secondes avec une phrase de description de scène et un format 9:16, directement utilisable sur les plateformes de vidéos courtes ou en diffusion dans le fil d'actualité.
- Présentations créatives publicitaires en amont — produisez rapidement plusieurs versions de propositions de plans en 720p, pour que le client sélectionne une direction à faible coût.
- Storyboard et prévisualisation narrative — transformez un texte de storyboard en clip animé avec son, pour expliquer les mouvements de caméra et le rythme à l'équipe de production.
- Contenus de style grand écran — choisissez le format 21:9 pour générer des clips paysage au rendu cinématographique, destinés aux génériques ou aux éléments d'image de marque.
Limites et conseils de choix
Seule l'entrée texte est actuellement prise en charge ; impossible de contraindre l'image par une image de référence ou des images de début et de fin, ce qui rend difficile le contrôle précis de la cohérence des personnages et de la composition pour les projets exigeants. Les informations publiques divergent quant à la résolution maximale ; cette voie se limite à 1080p. Le rendu en 1080p prend nettement plus de temps ; pour les clips longs, il est conseillé de tester au préalable la cohérence et la stabilité. Si une image source peut servir de point de départ, il faut passer à la voie image-vers-vidéo de la même série ; pour un simple brouillon rapide, la version Flash peut être envisagée.
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
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-4.0/text-to-video
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour kling-4.0/text-to-video et la route default — voir le tableau des paramètres ci-dessous.
promptstringRequisminLength 1maxLength 2500What happens in the shot: subject, action, camera movement, lighting and mood. Audio is generated together with the picture.
durationintegerOptionnelDéfaut: 5min 3max 30Clip length in seconds (3-30). Billed per second.
resolutionstringOptionnelDéfaut: "720p"Output resolution. 1080p takes noticeably longer to render than 720p.
720p1080paspect_ratiostringOptionnelDéfaut: "16:9"Frame shape of the output. 21:9 gives an ultrawide cinematic frame.
16:99:161:121:9callbackobjectOptionnel
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-4.0/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "720p",
"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-4.0/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "720p",
"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-4.0/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "720p",
"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 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
-
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 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
Modèles associés
Voir tous les modèles →Même type
-
Gemini Omni Google -- -
Grok Imagine 1.5 Lite xAI $0.029 /seconde -
Kling 2.5 Kuaishou $0.060 /seconde -
Seedance 2.5 ByteDance $0.121 /seconde -
Veo 3.1 Lite Google $0.060 /seconde -
Vidu Q4 Preview Vidu $0.051 /seconde -
Runway Gen 4.5 Runway $0.172 /seconde -
HappyHorse 1.1 Alibaba $0.160 /seconde -
FLUX 3 Video Black Forest Labs $0.090 /seconde -
Veo 3.1 Fast Google $0.170 /seconde -
Kling 3.0 Turbo Kuaishou $0.130 /seconde -
PixVerse V6 PixVerse $0.036 /seconde