Kling AI Texte-vers-Vidéo
Aperçu
Générez des vidéos à partir de prompts textuels via le point d'accès /v1/videos/text2video. Prend en charge les modèles v1 à v2.6, les modes standard/professionnel, le contrôle de caméra, les prompts négatifs et l'audio natif (v2.6+).
Point d'accès : POST https://api.klingai.com/v1/videos/text2video
Paramètres de la Requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
model_name | chaîne | Oui | Version du modèle (voir catalogue des modèles) |
prompt | chaîne | Oui | Description vidéo, max 2500 caractères |
negative_prompt | chaîne | Non | Ce qui doit être exclu de la génération |
duration | chaîne | Oui | "5" ou "10" secondes |
aspect_ratio | chaîne | Non | "16:9" (défaut), "9:16", "1:1", etc. |
mode | chaîne | Non | "standard" (défaut) ou "professional" |
cfg_scale | flottant | Non | Adhérence au prompt (0.0-1.0, défaut 0.5) |
camera_control | objet | Non | Configuration du mouvement de caméra |
callback_url | chaîne | Non | URL webhook pour notification d'achèvement |
Exemple Complet — Python
import jwt, time, os, requests
BASE = "https://api.klingai.com/v1"
def get_headers():
ak, sk = os.environ["KLING_ACCESS_KEY"], os.environ["KLING_SECRET_KEY"]
token = jwt.encode(
{"iss": ak, "exp": int(time.time()) + 1800, "nbf": int(time.time()) - 5},
sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"}
)
return {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
# Crée une tâche texte-vers-vidéo
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Plan de drone aérien d'un récif corallien à l'heure dorée, "
"poissons tropicaux nageant dans une eau cristalline, "
"rayons de soleil pénétrant la surface, cinématique 4K",
"negative_prompt": "flou, basse qualité, déformé, filigrane",
"duration": "5",
"aspect_ratio": "16:9",
"mode": "professional",
"cfg_scale": 0.5,
})
task = response.json()
task_id = task["data"]["task_id"]
# Interrogation jusqu'à achèvement
while True:
time.sleep(15)
result = requests.get(
f"{BASE}/videos/text2video/{task_id}", headers=get_headers()
).json()
status = result["data"]["task_status"]
if status == "succeed":
video = result["data"]["task_result"]["videos"][0]
print(f"URL de la vidéo : {video['url']}")
print(f"Durée : {video['duration']}s")
break
elif status == "failed":
raise RuntimeError(result["data"]["task_status_msg"])
# else : soumis/en cours — continuer l'interrogation
Avec Contrôle de Caméra
# Types de mouvement de caméra : pan, tilt, zoom, roll
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Un château médiéval sur une falaise au lever du soleil, brume dans la vallée",
"duration": "5",
"mode": "standard",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 5, # panoramique droite (négatif = gauche), plage -10 à 10
"vertical": 0, # inclinaison (négatif = bas, positif = haut)
"zoom": 3, # zoom avant (positif) ou arrière (négatif)
"roll": 0, # rotation
"pan": 0, # travelling gauche/droite
"tilt": -2, # travelling haut/bas
}
},
})
Règle : Un seul champ non nul dans config pour type: "simple".
Avec Audio Natif (v2.6 uniquement)
response = requests.post(f"{BASE}/videos/text2video", headers=get_headers(), json={
"model_name": "kling-v2-6",
"prompt": "Un groupe de jazz jouant dans un club faiblement éclairé, solo de saxophone, "
"applaudissements du public, lumière ambrée chaleureuse",
"duration": "10",
"mode": "professional",
"motion_has_audio": True, # génère un audio synchronisé
})
Conseils d'Ingénierie de Prompt
| Technique | Exemple |
|---|---|
| Scène + action + style | "Un samouraï marchant sous les cerisiers en fleurs, ralenti cinématographique" |
| Indices d'éclairage | "heure dorée", "lumière néon", "lumière diffuse par temps couvert" |
| Langage de caméra | "gros plan", "plan large d'établissement", "plan en travelling" |
| Prompt négatif | "flou, filigrane, superposition de texte, visages déformés" |
| Matériau/texture | "acier brossé", "aquarelle peinte à la main", "photorealiste" |
Référence des Coûts
| Durée | Standard | Professionnel |
|---|---|---|
| 5 secondes | 10 crédits | 35 crédits |
| 10 secondes | 20 crédits | 70 crédits |
Gestion des Erreurs
| Erreur | Cause | Correction |
|---|---|---|
400 prompt invalide | Vide ou >2500 caractères | Vérifier la longueur du prompt |
400 modèle invalide | model_name non pris en charge | Utiliser un ID de modèle valide du catalogue |
402 crédits insuffisants | Pas assez de crédits | Recharger le compte |
task_status: failed | Violation de la politique de contenu ou complexité | Simplifier le prompt, supprimer le contenu restreint |
Prérequis
- Un brief approuvé, un matériel de référence aux droits libres ou synthétique, un espace de travail et un budget autorisés, une vérification de la politique de contenu, et un propriétaire désigné pour la publication et la suppression.
Instructions
- Créer un brouillon en bac à sable à partir d'un brief approuvé ; ne pas inclure de personnes privées, de matériel protégé ou d'affirmations non vérifiées dans les prompts ou les téléchargements.
- Vérifier la durée demandée, le style, la destination, le budget de crédits, le statut de la politique de contenu et le réglage brouillon uniquement avant soumission.
- Examiner un rendu canary filigrané pour la politique, les droits et la qualité ; s'arrêter en cas de préoccupation relative à la politique ou à l'attribution et supprimer le brouillon plutôt que de le publier.
- Promouvoir seulement après approbation du propriétaire et conserver un reçu de production expurgé ; supprimer les actifs temporaires à la limite de conservation approuvée.
Sortie
Produire un reçu de rendu avec l'ID du brief, la classification approuvée de la source, le modèle/mode, la durée, l'estimation de crédits, le résultat de la vérification de la politique et des droits, la destination du brouillon, l'approbateur, la référence de conservation/suppression, et l'ID de la tâche. Exclure le texte du prompt, les identités et les informations d'identification.
Exemples
brief=synthetic-product-demo; source=rights-cleared; mode=standard; duration=5s; policy=pass; destination=draft-only; approval=pending; cleanup=24h est une requête canary sécurisée.