HappyHorse-1.1-T2V est un modèle d’Alibaba pour créer de courtes scènes vidéo à partir de texte. La description définit les personnages, les actions, le décor et le traitement visuel ; ce mode ne nécessite pas d’image source. Le modèle produit la vidéo et peut générer le son qui l’accompagne.
Le fabricant met en avant la compréhension du sens de la scène, la mise en scène cinématographique et l’expressivité des mouvements. Le texte peut définir l’atmosphère, les actions du personnage, le comportement des objets et la dynamique physique. Il permet de construire la scène autour de ce qui doit se produire, puis d’en orienter l’éclairage, l’angle de vue et les mouvements de caméra.
Les instructions sont obligatoires et peuvent être rédigées dans n’importe quelle langue. Elles peuvent contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois ; la partie excédentaire est ignorée. L’action, l’environnement et les détails visuels importants doivent être décrits dans cette limite. Cette mise en scène laisse au modèle la possibilité de créer une nouvelle scène au lieu de lui imposer une première image existante.
Dans ce mode, le texte est le principal moyen de contrôle. L’apparence précise d’un personnage ou d’un objet peut être décrite avec des mots ; la possibilité de la transmettre au moyen d’images distinctes relève d’un autre mode de la famille. Le résultat dépend de l’ensemble des instructions : une même graine aléatoire initiale aide donc à obtenir des variantes similaires, sans garantir une reproduction exacte.
Pour HappyHorse-1.1, la durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont prises en charge. Le fichier final est un MP4 à 24 images par seconde. Le modèle peut générer le son avec les images, en reliant l’accompagnement sonore à ce qui se passe dans la scène.
Le format peut être défini à l’avance. Les rapports 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 et 21:9 sont disponibles, du cadrage cinématographique large à la vidéo verticale allongée. La résolution, le format et la durée déterminent les dimensions du résultat ; le contenu et les mouvements sont définis par le texte.
Cette variante sert à créer une nouvelle scène à partir d’une idée formulée avec des mots. Elle convient à un court épisode, à une idée visuelle ou à une vidéo d’ambiance dont la mise en scène doit être décrite textuellement.
", "aboutText": "HappyHorse-1.1-T2V est un modèle d’Alibaba pour créer de courtes scènes vidéo à partir de texte. La description définit les personnages, les actions, le décor et le traitement visuel ; ce mode ne nécessite pas d’image source. Le modèle produit la vidéo et peut générer le son qui l’accompagne.\n\nLe fabricant met en avant la compréhension du sens de la scène, la mise en scène cinématographique et l’expressivité des mouvements. Le texte peut définir l’atmosphère, les actions du personnage, le comportement des objets et la dynamique physique. Il permet de construire la scène autour de ce qui doit se produire, puis d’en orienter l’éclairage, l’angle de vue et les mouvements de caméra.\n\n### Une mise en scène définie par les mots\n\nLes instructions sont obligatoires et peuvent être rédigées dans n’importe quelle langue. Elles peuvent contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois ; la partie excédentaire est ignorée. L’action, l’environnement et les détails visuels importants doivent être décrits dans cette limite. Cette mise en scène laisse au modèle la possibilité de créer une nouvelle scène au lieu de lui imposer une première image existante.\n\nDans ce mode, le texte est le principal moyen de contrôle. L’apparence précise d’un personnage ou d’un objet peut être décrite avec des mots ; la possibilité de la transmettre au moyen d’images distinctes relève d’un autre mode de la famille. Le résultat dépend de l’ensemble des instructions : une même graine aléatoire initiale aide donc à obtenir des variantes similaires, sans garantir une reproduction exacte.\n\n### Vidéo et accompagnement sonore\n\nPour HappyHorse-1.1, la durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont prises en charge. Le fichier final est un MP4 à 24 images par seconde. Le modèle peut générer le son avec les images, en reliant l’accompagnement sonore à ce qui se passe dans la scène.\n\nLe format peut être défini à l’avance. Les rapports 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 et 21:9 sont disponibles, du cadrage cinématographique large à la vidéo verticale allongée. La résolution, le format et la durée déterminent les dimensions du résultat ; le contenu et les mouvements sont définis par le texte.\n\nCette variante sert à créer une nouvelle scène à partir d’une idée formulée avec des mots. Elle convient à un court épisode, à une idée visuelle ou à une vidéo d’ambiance dont la mise en scène doit être décrite textuellement.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d599ffb228c039dcb364cfcb035ea28914b7bd1b08d8e71cc4fc623b2d81d39b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "happyhorse-1.1-t2vModèle de création de courtes vidéos avec son à partir d’une description textuelle. Il convient aux scènes dont les mouvements, la composition et le style visuel sont définis avec des mots.
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.
HappyHorse-1.1-T2V est un modèle d’Alibaba pour créer de courtes scènes vidéo à partir de texte. La description définit les personnages, les actions, le décor et le traitement visuel ; ce mode ne nécessite pas d’image source. Le modèle produit la vidéo et peut générer le son qui l’accompagne.
Le fabricant met en avant la compréhension du sens de la scène, la mise en scène cinématographique et l’expressivité des mouvements. Le texte peut définir l’atmosphère, les actions du personnage, le comportement des objets et la dynamique physique. Il permet de construire la scène autour de ce qui doit se produire, puis d’en orienter l’éclairage, l’angle de vue et les mouvements de caméra.
Les instructions sont obligatoires et peuvent être rédigées dans n’importe quelle langue. Elles peuvent contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois ; la partie excédentaire est ignorée. L’action, l’environnement et les détails visuels importants doivent être décrits dans cette limite. Cette mise en scène laisse au modèle la possibilité de créer une nouvelle scène au lieu de lui imposer une première image existante.
Dans ce mode, le texte est le principal moyen de contrôle. L’apparence précise d’un personnage ou d’un objet peut être décrite avec des mots ; la possibilité de la transmettre au moyen d’images distinctes relève d’un autre mode de la famille. Le résultat dépend de l’ensemble des instructions : une même graine aléatoire initiale aide donc à obtenir des variantes similaires, sans garantir une reproduction exacte.
Pour HappyHorse-1.1, la durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont prises en charge. Le fichier final est un MP4 à 24 images par seconde. Le modèle peut générer le son avec les images, en reliant l’accompagnement sonore à ce qui se passe dans la scène.
Le format peut être défini à l’avance. Les rapports 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 et 21:9 sont disponibles, du cadrage cinématographique large à la vidéo verticale allongée. La résolution, le format et la durée déterminent les dimensions du résultat ; le contenu et les mouvements sont définis par le texte.
Cette variante sert à créer une nouvelle scène à partir d’une idée formulée avec des mots. Elle convient à un court épisode, à une idée visuelle ou à une vidéo d’ambiance dont la mise en scène doit être décrite textuellement.
POST /v1/videos/generationstextvideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites happyhorse-1.1-t2v | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 3 Maximum: 15 Unité: secondes | Par défaut5 |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 480P, 720P, 1080P | Par défaut720P |
Champratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Par défaut16:9 |
Champimage_urls | Typehttps_url|data_image_url[] | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 0 Nombre maximal d’octets décodés: 20'971'520 Types MIME: image/jpeg, image/png, image/webp | Par défaut— |
Texte vers vidéo · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètrematerial_types | Contrattext |
Paramètreoptional | Contratduration, resolution, ratio |
Paramètreduration_integer_range | Contrat3, 15 |
Paramètredefault_duration | Contrat5 |
Paramètreresolution | Contrat480P, 720P, 1080P |
Paramètredefault_resolution | Contrat720P |
Paramètreratio | Contrat16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Paramètreratio_must_omit | Contratfalse |
Paramètreimage_urls | Contrat{"max_count":0} |
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/videos/generations/{request_id}/content
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
POST /v1/videos/generationsAiloot 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}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 scene brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-t2v", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nEnregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Conservez chaque élément de données et chaque indice de sortie renvoyés. content_url désigne uniquement le premier résultat ; récupérez chaque chemin de contenu ou ressource réel. GET du contenu sans index ne renvoie pas tous les résultats.
Consultez la tâche d’origine existante ; ne répétez jamais un envoi dont l’issue est inconnue.
| Champ | Type |
|---|---|
Champid | Typestring |
Champobject | Typestring |
Champmodel | Typestring |
Champstatus | Typestring |
Champcontent_url | Typesigned URL |
Champdata[] | Typesigned URL |
Champusage | Typeobject |
Champresult_pending_check | Typeboolean |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteConsultez périodiquement l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Ailoot happyhorse-1.1-t2v, happyhorse-t2v, happyhorse-t2v-latest
Utilisez les chemins de méthode indiqués ci-dessus.
happyhorse-t2vModèle de création de courtes vidéos avec son à partir d’une description textuelle. Il convient aux scènes dont les mouvements, la composition et le style visuel sont définis avec des mots.
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.
HappyHorse-1.1-T2V est un modèle d’Alibaba pour créer de courtes scènes vidéo à partir de texte. La description définit les personnages, les actions, le décor et le traitement visuel ; ce mode ne nécessite pas d’image source. Le modèle produit la vidéo et peut générer le son qui l’accompagne.
Le fabricant met en avant la compréhension du sens de la scène, la mise en scène cinématographique et l’expressivité des mouvements. Le texte peut définir l’atmosphère, les actions du personnage, le comportement des objets et la dynamique physique. Il permet de construire la scène autour de ce qui doit se produire, puis d’en orienter l’éclairage, l’angle de vue et les mouvements de caméra.
Les instructions sont obligatoires et peuvent être rédigées dans n’importe quelle langue. Elles peuvent contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois ; la partie excédentaire est ignorée. L’action, l’environnement et les détails visuels importants doivent être décrits dans cette limite. Cette mise en scène laisse au modèle la possibilité de créer une nouvelle scène au lieu de lui imposer une première image existante.
Dans ce mode, le texte est le principal moyen de contrôle. L’apparence précise d’un personnage ou d’un objet peut être décrite avec des mots ; la possibilité de la transmettre au moyen d’images distinctes relève d’un autre mode de la famille. Le résultat dépend de l’ensemble des instructions : une même graine aléatoire initiale aide donc à obtenir des variantes similaires, sans garantir une reproduction exacte.
Pour HappyHorse-1.1, la durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont prises en charge. Le fichier final est un MP4 à 24 images par seconde. Le modèle peut générer le son avec les images, en reliant l’accompagnement sonore à ce qui se passe dans la scène.
Le format peut être défini à l’avance. Les rapports 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 et 21:9 sont disponibles, du cadrage cinématographique large à la vidéo verticale allongée. La résolution, le format et la durée déterminent les dimensions du résultat ; le contenu et les mouvements sont définis par le texte.
Cette variante sert à créer une nouvelle scène à partir d’une idée formulée avec des mots. Elle convient à un court épisode, à une idée visuelle ou à une vidéo d’ambiance dont la mise en scène doit être décrite textuellement.
POST /v1/videos/generationstextvideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites happyhorse-t2v | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 3 Maximum: 15 Unité: secondes | Par défaut5 |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 480P, 720P, 1080P | Par défaut720P |
Champratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Par défaut16:9 |
Champimage_urls | Typehttps_url|data_image_url[] | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 0 Nombre maximal d’octets décodés: 20'971'520 Types MIME: image/jpeg, image/png, image/webp | Par défaut— |
Texte vers vidéo · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext |
Paramètrerequired | Contratnull |
Paramètreoptional_controls | Contratnull |
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/videos/generations/{request_id}/content
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
POST /v1/videos/generationsAiloot 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}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 scene brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-t2v", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nEnregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Conservez chaque élément de données et chaque indice de sortie renvoyés. content_url désigne uniquement le premier résultat ; récupérez chaque chemin de contenu ou ressource réel. GET du contenu sans index ne renvoie pas tous les résultats.
Consultez la tâche d’origine existante ; ne répétez jamais un envoi dont l’issue est inconnue.
| Champ | Type |
|---|---|
Champid | Typestring |
Champobject | Typestring |
Champmodel | Typestring |
Champstatus | Typestring |
Champcontent_url | Typesigned URL |
Champdata[] | Typesigned URL |
Champusage | Typeobject |
Champresult_pending_check | Typeboolean |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteConsultez périodiquement l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Ailoot happyhorse-1.1-t2v, happyhorse-t2v, happyhorse-t2v-latest
Utilisez les chemins de méthode indiqués ci-dessus.
happyhorse-t2v-latestModèle de création de courtes vidéos avec son à partir d’une description textuelle. Il convient aux scènes dont les mouvements, la composition et le style visuel sont définis avec des mots.
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.
HappyHorse-1.1-T2V est un modèle d’Alibaba pour créer de courtes scènes vidéo à partir de texte. La description définit les personnages, les actions, le décor et le traitement visuel ; ce mode ne nécessite pas d’image source. Le modèle produit la vidéo et peut générer le son qui l’accompagne.
Le fabricant met en avant la compréhension du sens de la scène, la mise en scène cinématographique et l’expressivité des mouvements. Le texte peut définir l’atmosphère, les actions du personnage, le comportement des objets et la dynamique physique. Il permet de construire la scène autour de ce qui doit se produire, puis d’en orienter l’éclairage, l’angle de vue et les mouvements de caméra.
Les instructions sont obligatoires et peuvent être rédigées dans n’importe quelle langue. Elles peuvent contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois ; la partie excédentaire est ignorée. L’action, l’environnement et les détails visuels importants doivent être décrits dans cette limite. Cette mise en scène laisse au modèle la possibilité de créer une nouvelle scène au lieu de lui imposer une première image existante.
Dans ce mode, le texte est le principal moyen de contrôle. L’apparence précise d’un personnage ou d’un objet peut être décrite avec des mots ; la possibilité de la transmettre au moyen d’images distinctes relève d’un autre mode de la famille. Le résultat dépend de l’ensemble des instructions : une même graine aléatoire initiale aide donc à obtenir des variantes similaires, sans garantir une reproduction exacte.
Pour HappyHorse-1.1, la durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont prises en charge. Le fichier final est un MP4 à 24 images par seconde. Le modèle peut générer le son avec les images, en reliant l’accompagnement sonore à ce qui se passe dans la scène.
Le format peut être défini à l’avance. Les rapports 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 et 21:9 sont disponibles, du cadrage cinématographique large à la vidéo verticale allongée. La résolution, le format et la durée déterminent les dimensions du résultat ; le contenu et les mouvements sont définis par le texte.
Cette variante sert à créer une nouvelle scène à partir d’une idée formulée avec des mots. Elle convient à un court épisode, à une idée visuelle ou à une vidéo d’ambiance dont la mise en scène doit être décrite textuellement.
POST /v1/videos/generationstextvideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites happyhorse-t2v-latest | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champduration | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 3 Maximum: 15 Unité: secondes | Par défaut5 |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 480P, 720P, 1080P | Par défaut720P |
Champratio | Typestring | ExigenceFacultatif | Valeurs et limites 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Par défaut16:9 |
Champimage_urls | Typehttps_url|data_image_url[] | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 0 Nombre maximal d’octets décodés: 20'971'520 Types MIME: image/jpeg, image/png, image/webp | Par défaut— |
Texte vers vidéo · Obligatoire : prompt
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext |
Paramètrerequired | Contratnull |
Paramètreoptional_controls | Contratnull |
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/videos/generations/{request_id}/content
Les structures des méthodes et les identifiants sont exacts ; la capacité du fournisseur est distincte de l’admission.
POST /v1/videos/generationsAiloot 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}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 scene brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-t2v-latest", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nEnregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.
Conservez chaque élément de données et chaque indice de sortie renvoyés. content_url désigne uniquement le premier résultat ; récupérez chaque chemin de contenu ou ressource réel. GET du contenu sans index ne renvoie pas tous les résultats.
Consultez la tâche d’origine existante ; ne répétez jamais un envoi dont l’issue est inconnue.
| Champ | Type |
|---|---|
Champid | Typestring |
Champobject | Typestring |
Champmodel | Typestring |
Champstatus | Typestring |
Champcontent_url | Typesigned URL |
Champdata[] | Typesigned URL |
Champusage | Typeobject |
Champresult_pending_check | Typeboolean |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Réponse409 · video_not_ready | ConditionLe contenu du résultat d’origine n’est pas encore disponible | Étape suivanteConsultez périodiquement l’identifiant d’origine renvoyé et respectez Retry-After. |
Réponseserver_error | ConditionLa réponse renvoyée indique que l’opération ou le résultat nécessite une vérification | Étape suivanteConservez l’identifiant d’opération/de tâche initialement renvoyé, les en-têtes de la requête et la réponse ; poursuivez les lectures prises en charge de cette opération d’origine. Ne soumettez pas à nouveau la requête de création. |
Ailoot happyhorse-1.1-t2v, happyhorse-t2v, happyhorse-t2v-latest
Utilisez les chemins de méthode indiqués ci-dessus.