Kling v1.5 est une édition de Kling dédiée à la génération vidéo, dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir d’images. L’image fixe fournie constitue le point de départ visuel, tandis que le descriptif écrit décrit la façon dont la scène doit s’animer. Utilisez ce modèle pour développer le geste d’un personnage, le mouvement d’un objet ou l’évolution d’un environnement à partir d’une image dont la composition convient déjà au plan.
Préparez l’image en mettant en valeur les détails importants du sujet. Pour un personnage, le visage, la pose et les vêtements doivent être lisibles; pour un objet, la silhouette doit être nette et les caractéristiques des matériaux visibles. Prévoyez dans la composition l’espace nécessaire au mouvement souhaité. Conservez l’image fixe d’origine avec la séquence terminée afin d’évaluer directement les changements d’apparence.
Décrivez l’action comme un événement observable. Par exemple, indiquez qu’une personne assise se tourne vers une fenêtre ou qu’un ruban de tissu bouge dans une brise légère. Précisez la direction du mouvement et la fin souhaitée. Lorsque plusieurs objets apparaissent, indiquez lequel agit et lesquels restent en place.
Expliquez le rôle de la caméra. Un point de vue fixe peut faciliter l’observation d’un petit geste, tandis qu’un point de vue mobile peut révéler un nouvel aspect de la scène. Décrivez ce mouvement par rapport au sujet. Demander à la caméra de s’approcher du sujet et demander au sujet de s’approcher de la caméra correspondent à des intentions visuelles différentes.
La fiche documentée de génération de vidéos à partir d’images propose des durées de cinq et dix secondes, les modes std et pro, ainsi que des cadrages paysage, portrait et carré. Choisissez les réglages proposés pour le flux de travail sélectionné avant d’évaluer le résultat. Lors de la comparaison de versions de plans, conservez le mode, la durée et le format d’image effectivement utilisés avec l’image source et le prompt.
Pour présenter un objet, définissez la caractéristique visuelle que le mouvement doit révéler. Il peut s’agir d’une surface réfléchissante, du pli d’un matériau ou de la forme d’une poignée. Gardez une action suffisamment ciblée pour que cette caractéristique importante reste visible. Évaluez l’objet pendant tout le mouvement et dans la vue finale utilisée au montage.
Pour une scène avec un personnage, décrivez un geste porteur de sens et la relation du personnage avec les objets proches. Examinez le visage, les mains, les vêtements et les proportions du corps au fil du temps. Vérifiez que le geste atteint le résultat final prévu et que la scène conserve une organisation cohérente des éléments du premier plan et de l’arrière-plan.
Conservez le clip généré dans son intégralité ainsi que les éléments sources utilisés. Examinez le début, l’action centrale et la fin comme une seule séquence, puis fondez les révisions sur un écart concret. Une note telle que «le personnage se détourne de la fenêtre» fournit au descriptif suivant une correction précise tout en préservant le reste de la scène.
", "aboutText": "Kling v1.5 est une édition de Kling dédiée à la génération vidéo, dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir d’images. L’image fixe fournie constitue le point de départ visuel, tandis que le descriptif écrit décrit la façon dont la scène doit s’animer. Utilisez ce modèle pour développer le geste d’un personnage, le mouvement d’un objet ou l’évolution d’un environnement à partir d’une image dont la composition convient déjà au plan.\n\nPréparez l’image en mettant en valeur les détails importants du sujet. Pour un personnage, le visage, la pose et les vêtements doivent être lisibles; pour un objet, la silhouette doit être nette et les caractéristiques des matériaux visibles. Prévoyez dans la composition l’espace nécessaire au mouvement souhaité. Conservez l’image fixe d’origine avec la séquence terminée afin d’évaluer directement les changements d’apparence.\n\nDécrivez l’action comme un événement observable. Par exemple, indiquez qu’une personne assise se tourne vers une fenêtre ou qu’un ruban de tissu bouge dans une brise légère. Précisez la direction du mouvement et la fin souhaitée. Lorsque plusieurs objets apparaissent, indiquez lequel agit et lesquels restent en place.\n\nExpliquez le rôle de la caméra. Un point de vue fixe peut faciliter l’observation d’un petit geste, tandis qu’un point de vue mobile peut révéler un nouvel aspect de la scène. Décrivez ce mouvement par rapport au sujet. Demander à la caméra de s’approcher du sujet et demander au sujet de s’approcher de la caméra correspondent à des intentions visuelles différentes.\n\nLa fiche documentée de génération de vidéos à partir d’images propose des durées de cinq et dix secondes, les modes std et pro, ainsi que des cadrages paysage, portrait et carré. Choisissez les réglages proposés pour le flux de travail sélectionné avant d’évaluer le résultat. Lors de la comparaison de versions de plans, conservez le mode, la durée et le format d’image effectivement utilisés avec l’image source et le prompt.\n\nPour présenter un objet, définissez la caractéristique visuelle que le mouvement doit révéler. Il peut s’agir d’une surface réfléchissante, du pli d’un matériau ou de la forme d’une poignée. Gardez une action suffisamment ciblée pour que cette caractéristique importante reste visible. Évaluez l’objet pendant tout le mouvement et dans la vue finale utilisée au montage.\n\nPour une scène avec un personnage, décrivez un geste porteur de sens et la relation du personnage avec les objets proches. Examinez le visage, les mains, les vêtements et les proportions du corps au fil du temps. Vérifiez que le geste atteint le résultat final prévu et que la scène conserve une organisation cohérente des éléments du premier plan et de l’arrière-plan.\n\nConservez le clip généré dans son intégralité ainsi que les éléments sources utilisés. Examinez le début, l’action centrale et la fin comme une seule séquence, puis fondez les révisions sur un écart concret. Une note telle que «le personnage se détourne de la fenêtre» fournit au descriptif suivant une correction précise tout en préservant le reste de la scène.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a54063b9b35036e9690d7ff773024c103ab525ea06a505af840f58f8ae209e99", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "kling-v1-5Kling v1.5 est un modèle vidéo dont le flux de travail de génération à partir d’images est documenté. Partez d’une image fixe préparée, puis décrivez le mouvement, le point de vue et la composition finale d’un court plan mettant en scène un personnage, un objet ou un environnement.
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 v1.5 est une édition de Kling dédiée à la génération vidéo, dont le catalogue documenté indique la prise en charge de la génération de vidéos à partir d’images. L’image fixe fournie constitue le point de départ visuel, tandis que le descriptif écrit décrit la façon dont la scène doit s’animer. Utilisez ce modèle pour développer le geste d’un personnage, le mouvement d’un objet ou l’évolution d’un environnement à partir d’une image dont la composition convient déjà au plan.
Préparez l’image en mettant en valeur les détails importants du sujet. Pour un personnage, le visage, la pose et les vêtements doivent être lisibles; pour un objet, la silhouette doit être nette et les caractéristiques des matériaux visibles. Prévoyez dans la composition l’espace nécessaire au mouvement souhaité. Conservez l’image fixe d’origine avec la séquence terminée afin d’évaluer directement les changements d’apparence.
Décrivez l’action comme un événement observable. Par exemple, indiquez qu’une personne assise se tourne vers une fenêtre ou qu’un ruban de tissu bouge dans une brise légère. Précisez la direction du mouvement et la fin souhaitée. Lorsque plusieurs objets apparaissent, indiquez lequel agit et lesquels restent en place.
Expliquez le rôle de la caméra. Un point de vue fixe peut faciliter l’observation d’un petit geste, tandis qu’un point de vue mobile peut révéler un nouvel aspect de la scène. Décrivez ce mouvement par rapport au sujet. Demander à la caméra de s’approcher du sujet et demander au sujet de s’approcher de la caméra correspondent à des intentions visuelles différentes.
La fiche documentée de génération de vidéos à partir d’images propose des durées de cinq et dix secondes, les modes std et pro, ainsi que des cadrages paysage, portrait et carré. Choisissez les réglages proposés pour le flux de travail sélectionné avant d’évaluer le résultat. Lors de la comparaison de versions de plans, conservez le mode, la durée et le format d’image effectivement utilisés avec l’image source et le prompt.
Pour présenter un objet, définissez la caractéristique visuelle que le mouvement doit révéler. Il peut s’agir d’une surface réfléchissante, du pli d’un matériau ou de la forme d’une poignée. Gardez une action suffisamment ciblée pour que cette caractéristique importante reste visible. Évaluez l’objet pendant tout le mouvement et dans la vue finale utilisée au montage.
Pour une scène avec un personnage, décrivez un geste porteur de sens et la relation du personnage avec les objets proches. Examinez le visage, les mains, les vêtements et les proportions du corps au fil du temps. Vérifiez que le geste atteint le résultat final prévu et que la scène conserve une organisation cohérente des éléments du premier plan et de l’arrière-plan.
Conservez le clip généré dans son intégralité ainsi que les éléments sources utilisés. Examinez le début, l’action centrale et la fin comme une seule séquence, puis fondez les révisions sur un écart concret. Une note telle que «le personnage se détourne de la fenêtre» fournit au descriptif suivant une correction précise tout en préservant le reste de la scène.
POST /v1/videostext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites kling-v1-5 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-v1-5", "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-v1-5
/v1/videos/generations