Kling v2.1 est un modèle vidéo Kling dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir d’images. Commencez par une image fixe de référence qui définit la scène, puis décrivez le mouvement qui en fera un plan exploitable. Une image de produit, un décor illustré ou une image de personnage peuvent fournir la composition à partir de laquelle la séquence se développe.
Choisissez une référence qui permette de comprendre l’action souhaitée. Un sujet placé à côté d’une porte constitue un point de départ clair pour entrer dans une pièce; un objet posé sur une surface dégagée facilite l’examen de sa silhouette. Préservez la qualité d’origine de la référence et conservez-la avec le clip généré.
Décrivez une action cohérente. Précisez le sujet, la direction du mouvement et l’état final souhaité. Pour une interaction, expliquez la relation entre les participants: qui tend la main, ce qui est touché et où l’action se termine. Utilisez des détails visibles qui pourront être vérifiés dans la séquence obtenue.
Cadrez le plan en fonction de son usage final. La fiche documentée de génération de vidéos à partir d’images propose des formats paysage, portrait et carré, avec des durées de cinq et dix secondes. Définissez l’emplacement que le sujet doit conserver dans le cadre choisi. Une composition en portrait et un large plan d’ensemble imposent des contraintes différentes à un même mouvement.
Les réglages documentés de génération de vidéos à partir d’images comprennent les modes de génération std et pro. Conservez le mode choisi avec le résultat lors de la comparaison des versions. Évaluez le résultat par rapport au descriptif: action demandée, composition, apparence du sujet et rythme. Le seul nom du mode ne permet pas de savoir dans quelle mesure un plan donné répond à ces besoins.
Utilisez les indications de caméra pour soutenir l’événement. Une caméra fixe peut montrer un changement de pose, un déplacement latéral peut révéler un décor et un mouvement vers l’avant peut mettre un détail en valeur. Précisez la relation souhaitée entre le sujet et le point de vue pour que le mouvement de caméra ne concurrence pas l’action que le spectateur doit suivre.
Vérifiez la continuité sur l’ensemble du clip. Pour un produit, examinez sa forme, ses marquages et l’apparence de ses matériaux lorsque le point de vue change. Pour une personne, examinez les traits du visage, les mains, les vêtements et les contacts avec les objets proches. Vérifiez la composition finale en tenant compte du plan ou de l’élément graphique qui suit au montage.
Enregistrez la vidéo terminée, la référence, le prompt et les réglages sélectionnés dans un même dossier de suivi du plan. Lors d’une révision, identifiez l’écart visuel précis et conservez les éléments qui servent déjà la scène. Comparez les versions à la même taille d’affichage et à la même vitesse de lecture afin de choisir en fonction du mouvement et de la composition que le public verra réellement.
", "aboutText": "Kling v2.1 est un modèle vidéo Kling dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir d’images. Commencez par une image fixe de référence qui définit la scène, puis décrivez le mouvement qui en fera un plan exploitable. Une image de produit, un décor illustré ou une image de personnage peuvent fournir la composition à partir de laquelle la séquence se développe.\n\nChoisissez une référence qui permette de comprendre l’action souhaitée. Un sujet placé à côté d’une porte constitue un point de départ clair pour entrer dans une pièce; un objet posé sur une surface dégagée facilite l’examen de sa silhouette. Préservez la qualité d’origine de la référence et conservez-la avec le clip généré.\n\nDécrivez une action cohérente. Précisez le sujet, la direction du mouvement et l’état final souhaité. Pour une interaction, expliquez la relation entre les participants: qui tend la main, ce qui est touché et où l’action se termine. Utilisez des détails visibles qui pourront être vérifiés dans la séquence obtenue.\n\nCadrez le plan en fonction de son usage final. La fiche documentée de génération de vidéos à partir d’images propose des formats paysage, portrait et carré, avec des durées de cinq et dix secondes. Définissez l’emplacement que le sujet doit conserver dans le cadre choisi. Une composition en portrait et un large plan d’ensemble imposent des contraintes différentes à un même mouvement.\n\nLes réglages documentés de génération de vidéos à partir d’images comprennent les modes de génération std et pro. Conservez le mode choisi avec le résultat lors de la comparaison des versions. Évaluez le résultat par rapport au descriptif: action demandée, composition, apparence du sujet et rythme. Le seul nom du mode ne permet pas de savoir dans quelle mesure un plan donné répond à ces besoins.\n\nUtilisez les indications de caméra pour soutenir l’événement. Une caméra fixe peut montrer un changement de pose, un déplacement latéral peut révéler un décor et un mouvement vers l’avant peut mettre un détail en valeur. Précisez la relation souhaitée entre le sujet et le point de vue pour que le mouvement de caméra ne concurrence pas l’action que le spectateur doit suivre.\n\nVérifiez la continuité sur l’ensemble du clip. Pour un produit, examinez sa forme, ses marquages et l’apparence de ses matériaux lorsque le point de vue change. Pour une personne, examinez les traits du visage, les mains, les vêtements et les contacts avec les objets proches. Vérifiez la composition finale en tenant compte du plan ou de l’élément graphique qui suit au montage.\n\nEnregistrez la vidéo terminée, la référence, le prompt et les réglages sélectionnés dans un même dossier de suivi du plan. Lors d’une révision, identifiez l’écart visuel précis et conservez les éléments qui servent déjà la scène. Comparez les versions à la même taille d’affichage et à la même vitesse de lecture afin de choisir en fonction du mouvement et de la composition que le public verra réellement.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7368817ece8aec60749dcec7ba05706628b90611fd00125b1c8028038e11f78f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "kling-v2-1Kling v2.1 génère des vidéos à partir d’une image de référence et d’un descriptif écrit du mouvement. Sa fiche documentée de génération à partir d’images propose des durées de cinq et dix secondes, ainsi que les modes std et pro pour préparer la séquence.
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 est un modèle vidéo Kling dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir d’images. Commencez par une image fixe de référence qui définit la scène, puis décrivez le mouvement qui en fera un plan exploitable. Une image de produit, un décor illustré ou une image de personnage peuvent fournir la composition à partir de laquelle la séquence se développe.
Choisissez une référence qui permette de comprendre l’action souhaitée. Un sujet placé à côté d’une porte constitue un point de départ clair pour entrer dans une pièce; un objet posé sur une surface dégagée facilite l’examen de sa silhouette. Préservez la qualité d’origine de la référence et conservez-la avec le clip généré.
Décrivez une action cohérente. Précisez le sujet, la direction du mouvement et l’état final souhaité. Pour une interaction, expliquez la relation entre les participants: qui tend la main, ce qui est touché et où l’action se termine. Utilisez des détails visibles qui pourront être vérifiés dans la séquence obtenue.
Cadrez le plan en fonction de son usage final. La fiche documentée de génération de vidéos à partir d’images propose des formats paysage, portrait et carré, avec des durées de cinq et dix secondes. Définissez l’emplacement que le sujet doit conserver dans le cadre choisi. Une composition en portrait et un large plan d’ensemble imposent des contraintes différentes à un même mouvement.
Les réglages documentés de génération de vidéos à partir d’images comprennent les modes de génération std et pro. Conservez le mode choisi avec le résultat lors de la comparaison des versions. Évaluez le résultat par rapport au descriptif: action demandée, composition, apparence du sujet et rythme. Le seul nom du mode ne permet pas de savoir dans quelle mesure un plan donné répond à ces besoins.
Utilisez les indications de caméra pour soutenir l’événement. Une caméra fixe peut montrer un changement de pose, un déplacement latéral peut révéler un décor et un mouvement vers l’avant peut mettre un détail en valeur. Précisez la relation souhaitée entre le sujet et le point de vue pour que le mouvement de caméra ne concurrence pas l’action que le spectateur doit suivre.
Vérifiez la continuité sur l’ensemble du clip. Pour un produit, examinez sa forme, ses marquages et l’apparence de ses matériaux lorsque le point de vue change. Pour une personne, examinez les traits du visage, les mains, les vêtements et les contacts avec les objets proches. Vérifiez la composition finale en tenant compte du plan ou de l’élément graphique qui suit au montage.
Enregistrez la vidéo terminée, la référence, le prompt et les réglages sélectionnés dans un même dossier de suivi du plan. Lors d’une révision, identifiez l’écart visuel précis et conservez les éléments qui servent déjà la scène. Comparez les versions à la même taille d’affichage et à la même vitesse de lecture afin de choisir en fonction du mouvement et de la composition que le public verra réellement.
POST /v1/videostext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites kling-v2-1 Conditions: Utilisez exactement ce sélecteur de routage Ailoot. | Par défaut— |
Champmode | Typestring | ExigenceFacultatif | Valeurs et limites std, pro Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée. | Par défautstd |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 9:16, 1:1 Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée. | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites 5, 10 Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée. | Par défaut— |
Champend_image | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée. | Par défaut— |
Champimage | Typestring or array<string> | ExigenceObligatoire | Valeurs et limites Conditions: Fournissez l’URL réelle et accessible de votre image. Une liste n’est acceptée que si le schéma du paramètre prévoit un tableau. | Par défaut— |
Champnegative_prompt | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée. | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Conditions: Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée. | Par défaut— |
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt, image |
Paramètreoptional | Contratmode, aspect_ratio, duration, end_image, negative_prompt |
Paramètrematerial_types | Contrattext, image |
Paramètreconditions | ContratUtilisez exactement ce sélecteur de routage Ailoot., Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée., Fournissez l’URL réelle et accessible de votre image. Une liste n’est acceptée que si le schéma du paramètre prévoit un tableau., Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisée., Utilisez le champ documenté pour le modèle sélectionné et les choix proposés ; omettez toute valeur facultative non précisé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\n: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "kling-v2-1", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')\np['image']=os.environ['AILOOT_IMAGE_URL']\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 les 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 tous les rôles qui y font référence.
Conservez l’identifiant public id de la tâche ou de l’opération renvoyée, 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 |
Champtask_id | Typestring |
Champstatus | Typestring |
Champvideo_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 des données d’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 un contrôle. | É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 une nouvelle fois la requête de création. |
Ailoot Ultra kling-v2-1
/v1/videos/generations