Kling v2.1 Master est une édition vidéo Kling dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir de texte et d’images. Choisissez un brief écrit décrivant la scène pour développer une idée visuelle à partir de texte, ou un brief basé sur une image lorsque le sujet et la composition sont déjà définis. Dans les deux cas, précisez l’événement que le plan terminé doit montrer.
Pour une création à partir de texte, décrivez le sujet, le décor et l’action dans un ordre clair. Un danseur traversant un studio, un véhicule passant sous des arbres ou un objet en verre captant une lumière changeante donnent chacun un objectif précis à la séquence. Incluez les détails qui déterminent l’apparence de la scène et veillez à leur cohérence dans tout le brief.
Pour une création à partir d’une image, préparez une référence montrant les caractéristiques que le plan doit préserver. Gardez visibles les visages, les contours des objets et les matériaux distinctifs. Décrivez ce qui change par rapport à cette vue initiale : le geste du sujet, un mouvement dans l’environnement ou la position de la caméra. Gardez l’image source à portée de main lors de l’examen du résultat.
Préparez l’action en fonction de sa fin. Une personne qui pose un objet doit terminer avec cet objet à un endroit identifiable ; un dévoilement doit se conclure avec la caractéristique importante visible. Il sera ainsi plus facile de choisir un point de coupe et d’évaluer si le mouvement a rempli son objectif.
La fiche documentée du modèle comprend des durées de cinq et dix secondes, les modes std et pro, ainsi que des formats d’image paysage, portrait et carré. Choisissez les commandes disponibles dans le flux de travail sélectionné et conservez les valeurs effectivement utilisées. Évaluez le clip obtenu par rapport à l’action et au cadrage souhaités plutôt qu’au nom de l’édition du modèle.
Décrivez séparément le mouvement du sujet et celui de la caméra. Pour un travelling d’accompagnement, précisez quel sujet la caméra suit et quels éléments de l’environnement doivent défiler dans le cadre. Pour un plan fixe, indiquez le mouvement qui s’y déroule. Reliez les indications de caméra à ce que le spectateur doit remarquer.
Examinez la continuité de l’ensemble de la séquence. Vérifiez que le sujet important reste reconnaissable, que les interactions sont cohérentes dans l’espace et que le rythme laisse la place à la coupe prévue. Observez les changements dans les mains, les visages, les détails des surfaces et les objets qui se chevauchent. Évaluez le mouvement autant que la meilleure image prise isolément.
Conservez chaque vidéo terminée avec son prompt, sa référence et ses réglages. Utilisez le même brief pour comparer une scène entre plusieurs éditions, et notez les différences visuelles réelles. Pour corriger une proposition, décrivez le problème observé et révisez la consigne correspondante tout en conservant les éléments utiles de la scène.
", "aboutText": "Kling v2.1 Master est une édition vidéo Kling dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir de texte et d’images. Choisissez un brief écrit décrivant la scène pour développer une idée visuelle à partir de texte, ou un brief basé sur une image lorsque le sujet et la composition sont déjà définis. Dans les deux cas, précisez l’événement que le plan terminé doit montrer.\n\nPour une création à partir de texte, décrivez le sujet, le décor et l’action dans un ordre clair. Un danseur traversant un studio, un véhicule passant sous des arbres ou un objet en verre captant une lumière changeante donnent chacun un objectif précis à la séquence. Incluez les détails qui déterminent l’apparence de la scène et veillez à leur cohérence dans tout le brief.\n\nPour une création à partir d’une image, préparez une référence montrant les caractéristiques que le plan doit préserver. Gardez visibles les visages, les contours des objets et les matériaux distinctifs. Décrivez ce qui change par rapport à cette vue initiale : le geste du sujet, un mouvement dans l’environnement ou la position de la caméra. Gardez l’image source à portée de main lors de l’examen du résultat.\n\nPréparez l’action en fonction de sa fin. Une personne qui pose un objet doit terminer avec cet objet à un endroit identifiable ; un dévoilement doit se conclure avec la caractéristique importante visible. Il sera ainsi plus facile de choisir un point de coupe et d’évaluer si le mouvement a rempli son objectif.\n\nLa fiche documentée du modèle comprend des durées de cinq et dix secondes, les modes std et pro, ainsi que des formats d’image paysage, portrait et carré. Choisissez les commandes disponibles dans le flux de travail sélectionné et conservez les valeurs effectivement utilisées. Évaluez le clip obtenu par rapport à l’action et au cadrage souhaités plutôt qu’au nom de l’édition du modèle.\n\nDécrivez séparément le mouvement du sujet et celui de la caméra. Pour un travelling d’accompagnement, précisez quel sujet la caméra suit et quels éléments de l’environnement doivent défiler dans le cadre. Pour un plan fixe, indiquez le mouvement qui s’y déroule. Reliez les indications de caméra à ce que le spectateur doit remarquer.\n\nExaminez la continuité de l’ensemble de la séquence. Vérifiez que le sujet important reste reconnaissable, que les interactions sont cohérentes dans l’espace et que le rythme laisse la place à la coupe prévue. Observez les changements dans les mains, les visages, les détails des surfaces et les objets qui se chevauchent. Évaluez le mouvement autant que la meilleure image prise isolément.\n\nConservez chaque vidéo terminée avec son prompt, sa référence et ses réglages. Utilisez le même brief pour comparer une scène entre plusieurs éditions, et notez les différences visuelles réelles. Pour corriger une proposition, décrivez le problème observé et révisez la consigne correspondante tout en conservant les éléments utiles de la scène.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c64b13d74a43a701b6ba5388c6385d5497273772f57c9fa6536e794f8ee43580", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-be", "methods": [ { "html": "kling-v2-1-masterKling v2.1 Master génère des vidéos à partir d’un texte ou d’un brief basé sur une image. Utilisez-le pour un événement visuel défini, en préparant le sujet, l’action, les indications de caméra et la fin comme les éléments d’un même court plan cohérent.
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Kling v2.1 Master est une édition vidéo Kling dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir de texte et d’images. Choisissez un brief écrit décrivant la scène pour développer une idée visuelle à partir de texte, ou un brief basé sur une image lorsque le sujet et la composition sont déjà définis. Dans les deux cas, précisez l’événement que le plan terminé doit montrer.
Pour une création à partir de texte, décrivez le sujet, le décor et l’action dans un ordre clair. Un danseur traversant un studio, un véhicule passant sous des arbres ou un objet en verre captant une lumière changeante donnent chacun un objectif précis à la séquence. Incluez les détails qui déterminent l’apparence de la scène et veillez à leur cohérence dans tout le brief.
Pour une création à partir d’une image, préparez une référence montrant les caractéristiques que le plan doit préserver. Gardez visibles les visages, les contours des objets et les matériaux distinctifs. Décrivez ce qui change par rapport à cette vue initiale : le geste du sujet, un mouvement dans l’environnement ou la position de la caméra. Gardez l’image source à portée de main lors de l’examen du résultat.
Préparez l’action en fonction de sa fin. Une personne qui pose un objet doit terminer avec cet objet à un endroit identifiable ; un dévoilement doit se conclure avec la caractéristique importante visible. Il sera ainsi plus facile de choisir un point de coupe et d’évaluer si le mouvement a rempli son objectif.
La fiche documentée du modèle comprend des durées de cinq et dix secondes, les modes std et pro, ainsi que des formats d’image paysage, portrait et carré. Choisissez les commandes disponibles dans le flux de travail sélectionné et conservez les valeurs effectivement utilisées. Évaluez le clip obtenu par rapport à l’action et au cadrage souhaités plutôt qu’au nom de l’édition du modèle.
Décrivez séparément le mouvement du sujet et celui de la caméra. Pour un travelling d’accompagnement, précisez quel sujet la caméra suit et quels éléments de l’environnement doivent défiler dans le cadre. Pour un plan fixe, indiquez le mouvement qui s’y déroule. Reliez les indications de caméra à ce que le spectateur doit remarquer.
Examinez la continuité de l’ensemble de la séquence. Vérifiez que le sujet important reste reconnaissable, que les interactions sont cohérentes dans l’espace et que le rythme laisse la place à la coupe prévue. Observez les changements dans les mains, les visages, les détails des surfaces et les objets qui se chevauchent. Évaluez le mouvement autant que la meilleure image prise isolément.
Conservez chaque vidéo terminée avec son prompt, sa référence et ses réglages. Utilisez le même brief pour comparer une scène entre plusieurs éditions, et notez les différences visuelles réelles. Pour corriger une proposition, décrivez le problème observé et révisez la consigne correspondante tout en conservant les éléments utiles de la scène.
POST /v1/videostextvideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites kling-v2-1-master Conditions: Utilisez exactement ce sélecteur de routage Ailoot. | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur maximale: 500 Conditions: | Par défaut— |
Champmode | Typestring | ExigenceObligatoire | Valeurs et limites std, pro Conditions: | Par défaut— |
Champmodel_name | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Valeur native de remplacement facultative. Omettez-la pour utiliser automatiquement le modèle sélectionné ; une valeur explicite est conservée. | Par défaut— |
Champcfg_scale | Typenumber | ExigenceFacultatif | Valeurs et limites Minimum: 0 Maximum: 1 Conditions: | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: | Par défaut— |
Champnegative_prompt | Typestring | ExigenceFacultatif | Valeurs et limites Longueur maximale: 200 Conditions: | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites 5, 10 Conditions: | Par défaut— |
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, mode |
Paramètreoptional | Contratmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Paramètrematerial_types | Contrattext |
Paramètreconditions | ContratUtilisez exactement ce sélecteur de routage Ailoot., Valeur native de remplacement facultative. Omettez-la pour utiliser automatiquement le modèle sélectionné ; une valeur explicite est conservée. |
Alias de méthode : /v1/videos/generations
Cycle de vie : submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $6 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\\x89PNG\\r\\n\\x1a\\n" else "jpg" if raw[:3]==b"\\xff\\xd8\\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Conservez la réponse complète et ses en-têtes, les identifiants d’origine, chaque résultat réel et tous les champs de consommation et de comptabilisation. Enregistrez chaque ressource unique dont vous êtes propriétaire et conservez chaque rôle qui y renvoie.
Conservez l’id public de la tâche ou de l’opération renvoyé ainsi que tous les en-têtes. Consultez uniquement la tâche d’origine ; unknown ou result_pending_check n’autorise pas une nouvelle création.
| Champ | Type |
|---|---|
Champid | Typestring |
Champpolling_url | Typestring |
Champprovider_task_id | Typestring |
Champdata.task_id | Typestring |
Champdata.task_status | Typestring |
Champdata.task_result.videos[].url | Typestring |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionUn champ obligatoire, un sélecteur de modèle, un type ou une représentation de l’entrée est invalide. | Étape suivanteExaminez les détails de validation renvoyés avant de préparer une requête distincte. |
Réponse | ConditionLa requête d’origine ou son résultat est inconnu ou nécessite une vérification. | Étape suivanteConservez les identifiants et les en-têtes d’origine ; consultez uniquement les enregistrements d’état ou de bibliothèque pris en charge. Ne soumettez pas à nouveau la requête de création. |
Ailoot Ultra kling-v2-1-master
/v1/videos/generations