HappyHorse-1.1-I2V est un modèle d’Alibaba qui commence une scène vidéo à partir d’une image existante. Celle-ci devient la première image de la vidéo, et le texte peut définir l’action qui suit : mouvement du personnage, changements dans la scène et déplacement de la caméra. Ce mode convient pour animer une illustration, une photographie d’objet ou un concept visuel préparé à l’avance.
La description textuelle est facultative. En son absence, le modèle déduit lui-même un mouvement possible à partir du contenu de l’image initiale. Lorsqu’une description est fournie, l’image source détermine la composition et l’apparence des objets, tandis que les mots guident l’évolution de la scène dans le temps.
Alibaba met en avant la préservation de l’apparence du personnage, la cohérence visuelle, la fluidité des mouvements et l’association de l’image et du son. La stabilité des inscriptions et des textures figure également parmi les caractéristiques annoncées. Ces propriétés décrivent la conception du modèle et ne signifient pas que chaque pixel est conservé à l’identique dans toutes les images générées.
Ce mode utilise une seule image initiale. Elle définit la scène de départ, et non un ensemble de références indépendantes pour une nouvelle composition. La possibilité de définir séparément une image finale n’est pas annoncée pour cette version précise.
Les formats JPEG, JPG, PNG et WEBP sont acceptés. Chaque côté de l’image d’entrée doit mesurer au moins 300 pixels ; le rapport largeur/hauteur admis va de 1:2,5 à 2,5:1, et le fichier peut peser jusqu’à 20 Mo. La vidéo produite reprend le rapport largeur/hauteur de la première image.
La durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont disponibles ; la sortie est un fichier MP4 à 24 images par seconde. La création d’un accompagnement sonore avec la vidéo est prise en charge.
La description peut être rédigée dans n’importe quelle langue et contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois. La partie qui dépasse cette limite est ignorée : les actions importantes et les particularités du mouvement doivent donc tenir dans les instructions. Une même graine aléatoire initiale peut produire des vidéos similaires, mais ne garantit pas qu’elles soient identiques image par image.
", "aboutText": "HappyHorse-1.1-I2V est un modèle d’Alibaba qui commence une scène vidéo à partir d’une image existante. Celle-ci devient la première image de la vidéo, et le texte peut définir l’action qui suit : mouvement du personnage, changements dans la scène et déplacement de la caméra. Ce mode convient pour animer une illustration, une photographie d’objet ou un concept visuel préparé à l’avance.\n\nLa description textuelle est facultative. En son absence, le modèle déduit lui-même un mouvement possible à partir du contenu de l’image initiale. Lorsqu’une description est fournie, l’image source détermine la composition et l’apparence des objets, tandis que les mots guident l’évolution de la scène dans le temps.\n\n### De la première image au mouvement\n\nAlibaba met en avant la préservation de l’apparence du personnage, la cohérence visuelle, la fluidité des mouvements et l’association de l’image et du son. La stabilité des inscriptions et des textures figure également parmi les caractéristiques annoncées. Ces propriétés décrivent la conception du modèle et ne signifient pas que chaque pixel est conservé à l’identique dans toutes les images générées.\n\nCe mode utilise une seule image initiale. Elle définit la scène de départ, et non un ensemble de références indépendantes pour une nouvelle composition. La possibilité de définir séparément une image finale n’est pas annoncée pour cette version précise.\n\nLes formats JPEG, JPG, PNG et WEBP sont acceptés. Chaque côté de l’image d’entrée doit mesurer au moins 300 pixels ; le rapport largeur/hauteur admis va de 1:2,5 à 2,5:1, et le fichier peut peser jusqu’à 20 Mo. La vidéo produite reprend le rapport largeur/hauteur de la première image.\n\n### Paramètres de la vidéo\n\nLa durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont disponibles ; la sortie est un fichier MP4 à 24 images par seconde. La création d’un accompagnement sonore avec la vidéo est prise en charge.\n\nLa description peut être rédigée dans n’importe quelle langue et contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois. La partie qui dépasse cette limite est ignorée : les actions importantes et les particularités du mouvement doivent donc tenir dans les instructions. Une même graine aléatoire initiale peut produire des vidéos similaires, mais ne garantit pas qu’elles soient identiques image par image.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "84709d82f2d7b5c5e5ed6f17a3d34367d0a316c3e0cab2dba418e3098267c8ff", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ca", "methods": [ { "html": "happyhorse-1.1-i2vModèle d’animation d’image : l’image source définit la première image de la vidéo, et la description guide les mouvements suivants. Il crée une courte vidéo avec possibilité d’accompagnement sonore.
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-I2V est un modèle d’Alibaba qui commence une scène vidéo à partir d’une image existante. Celle-ci devient la première image de la vidéo, et le texte peut définir l’action qui suit : mouvement du personnage, changements dans la scène et déplacement de la caméra. Ce mode convient pour animer une illustration, une photographie d’objet ou un concept visuel préparé à l’avance.
La description textuelle est facultative. En son absence, le modèle déduit lui-même un mouvement possible à partir du contenu de l’image initiale. Lorsqu’une description est fournie, l’image source détermine la composition et l’apparence des objets, tandis que les mots guident l’évolution de la scène dans le temps.
Alibaba met en avant la préservation de l’apparence du personnage, la cohérence visuelle, la fluidité des mouvements et l’association de l’image et du son. La stabilité des inscriptions et des textures figure également parmi les caractéristiques annoncées. Ces propriétés décrivent la conception du modèle et ne signifient pas que chaque pixel est conservé à l’identique dans toutes les images générées.
Ce mode utilise une seule image initiale. Elle définit la scène de départ, et non un ensemble de références indépendantes pour une nouvelle composition. La possibilité de définir séparément une image finale n’est pas annoncée pour cette version précise.
Les formats JPEG, JPG, PNG et WEBP sont acceptés. Chaque côté de l’image d’entrée doit mesurer au moins 300 pixels ; le rapport largeur/hauteur admis va de 1:2,5 à 2,5:1, et le fichier peut peser jusqu’à 20 Mo. La vidéo produite reprend le rapport largeur/hauteur de la première image.
La durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont disponibles ; la sortie est un fichier MP4 à 24 images par seconde. La création d’un accompagnement sonore avec la vidéo est prise en charge.
La description peut être rédigée dans n’importe quelle langue et contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois. La partie qui dépasse cette limite est ignorée : les actions importantes et les particularités du mouvement doivent donc tenir dans les instructions. Une même graine aléatoire initiale peut produire des vidéos similaires, mais ne garantit pas qu’elles soient identiques image par image.
POST /v1/videos/generationstext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites happyhorse-1.1-i2v | Par défaut— |
Champprompt | Typestring | ExigenceFacultatif | 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 | ExigenceNon pris en charge | Valeurs et limites | Par défaut— |
Champimage_urls | Typehttps_url|data_image_url[] | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 Nombre maximal d’octets décodés: 20 971 520 Types MIME: image/jpeg, image/png, image/webp | Par défaut— |
first_frame_to_video · Obligatoire : image_urls
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, image_urls |
Paramètrematerial_types | Contrattext, image |
Paramètreoptional | Contratduration, resolution, ratio, prompt |
Paramètreduration_integer_range | Contrat3, 15 |
Paramètredefault_duration | Contrat5 |
Paramètreresolution | Contrat480P, 720P, 1080P |
Paramètredefault_resolution | Contrat720P |
Paramètreratio | Contrat |
Paramètreratio_must_omit | Contrattrue |
Paramètreimage_urls | Contrat{"min_count":1,"max_count":1,"schemes":["https","données matricielles en base64"],"max_data_image_bytes":20971520} |
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 ID sont exacts ; la capacité du fournisseur est distincte de l’admission des requêtes.
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_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\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 retourné et chaque index de sortie. content_url désigne seulement la première sortie; récupérez chaque chemin de contenu et ressource réels. Un GET du contenu sans index ne retourne pas toutes les sorties.
Consultez la tâche d’origine existante; ne soumettez jamais de nouveau un envoi dont l’état est inconnu.
| 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 éléments fournis ou valeur de paramètre invalides | É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 suivanteInterrogez l’identifiant d’origine retourné 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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Utilisez les chemins de méthode indiqués ci-dessus.
happyhorse-i2vModèle d’animation d’image : l’image source définit la première image de la vidéo, et la description guide les mouvements suivants. Il crée une courte vidéo avec possibilité d’accompagnement sonore.
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-I2V est un modèle d’Alibaba qui commence une scène vidéo à partir d’une image existante. Celle-ci devient la première image de la vidéo, et le texte peut définir l’action qui suit : mouvement du personnage, changements dans la scène et déplacement de la caméra. Ce mode convient pour animer une illustration, une photographie d’objet ou un concept visuel préparé à l’avance.
La description textuelle est facultative. En son absence, le modèle déduit lui-même un mouvement possible à partir du contenu de l’image initiale. Lorsqu’une description est fournie, l’image source détermine la composition et l’apparence des objets, tandis que les mots guident l’évolution de la scène dans le temps.
Alibaba met en avant la préservation de l’apparence du personnage, la cohérence visuelle, la fluidité des mouvements et l’association de l’image et du son. La stabilité des inscriptions et des textures figure également parmi les caractéristiques annoncées. Ces propriétés décrivent la conception du modèle et ne signifient pas que chaque pixel est conservé à l’identique dans toutes les images générées.
Ce mode utilise une seule image initiale. Elle définit la scène de départ, et non un ensemble de références indépendantes pour une nouvelle composition. La possibilité de définir séparément une image finale n’est pas annoncée pour cette version précise.
Les formats JPEG, JPG, PNG et WEBP sont acceptés. Chaque côté de l’image d’entrée doit mesurer au moins 300 pixels ; le rapport largeur/hauteur admis va de 1:2,5 à 2,5:1, et le fichier peut peser jusqu’à 20 Mo. La vidéo produite reprend le rapport largeur/hauteur de la première image.
La durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont disponibles ; la sortie est un fichier MP4 à 24 images par seconde. La création d’un accompagnement sonore avec la vidéo est prise en charge.
La description peut être rédigée dans n’importe quelle langue et contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois. La partie qui dépasse cette limite est ignorée : les actions importantes et les particularités du mouvement doivent donc tenir dans les instructions. Une même graine aléatoire initiale peut produire des vidéos similaires, mais ne garantit pas qu’elles soient identiques image par image.
POST /v1/videos/generationstext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites happyhorse-i2v | Par défaut— |
Champprompt | Typestring | ExigenceFacultatif | 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 | ExigenceNon pris en charge | Valeurs et limites | Par défaut— |
Champimage_urls | Typehttps_url|data_image_url[] | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 Nombre maximal d’octets décodés: 20 971 520 Types MIME: image/jpeg, image/png, image/webp | Par défaut— |
first_frame_to_video · Obligatoire : image_urls
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext, image |
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 ID sont exacts ; la capacité du fournisseur est distincte de l’admission des requêtes.
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_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\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 retourné et chaque index de sortie. content_url désigne seulement la première sortie; récupérez chaque chemin de contenu et ressource réels. Un GET du contenu sans index ne retourne pas toutes les sorties.
Consultez la tâche d’origine existante; ne soumettez jamais de nouveau un envoi dont l’état est inconnu.
| 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 éléments fournis ou valeur de paramètre invalides | É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 suivanteInterrogez l’identifiant d’origine retourné 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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Utilisez les chemins de méthode indiqués ci-dessus.
happyhorse-i2v-latestModèle d’animation d’image : l’image source définit la première image de la vidéo, et la description guide les mouvements suivants. Il crée une courte vidéo avec possibilité d’accompagnement sonore.
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-I2V est un modèle d’Alibaba qui commence une scène vidéo à partir d’une image existante. Celle-ci devient la première image de la vidéo, et le texte peut définir l’action qui suit : mouvement du personnage, changements dans la scène et déplacement de la caméra. Ce mode convient pour animer une illustration, une photographie d’objet ou un concept visuel préparé à l’avance.
La description textuelle est facultative. En son absence, le modèle déduit lui-même un mouvement possible à partir du contenu de l’image initiale. Lorsqu’une description est fournie, l’image source détermine la composition et l’apparence des objets, tandis que les mots guident l’évolution de la scène dans le temps.
Alibaba met en avant la préservation de l’apparence du personnage, la cohérence visuelle, la fluidité des mouvements et l’association de l’image et du son. La stabilité des inscriptions et des textures figure également parmi les caractéristiques annoncées. Ces propriétés décrivent la conception du modèle et ne signifient pas que chaque pixel est conservé à l’identique dans toutes les images générées.
Ce mode utilise une seule image initiale. Elle définit la scène de départ, et non un ensemble de références indépendantes pour une nouvelle composition. La possibilité de définir séparément une image finale n’est pas annoncée pour cette version précise.
Les formats JPEG, JPG, PNG et WEBP sont acceptés. Chaque côté de l’image d’entrée doit mesurer au moins 300 pixels ; le rapport largeur/hauteur admis va de 1:2,5 à 2,5:1, et le fichier peut peser jusqu’à 20 Mo. La vidéo produite reprend le rapport largeur/hauteur de la première image.
La durée se choisit sous forme d’un nombre entier de 3 à 15 secondes. Les résolutions 480P, 720P et 1080P sont disponibles ; la sortie est un fichier MP4 à 24 images par seconde. La création d’un accompagnement sonore avec la vidéo est prise en charge.
La description peut être rédigée dans n’importe quelle langue et contenir jusqu’à 5000 caractères non chinois ou 2500 caractères chinois. La partie qui dépasse cette limite est ignorée : les actions importantes et les particularités du mouvement doivent donc tenir dans les instructions. Une même graine aléatoire initiale peut produire des vidéos similaires, mais ne garantit pas qu’elles soient identiques image par image.
POST /v1/videos/generationstext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites happyhorse-i2v-latest | Par défaut— |
Champprompt | Typestring | ExigenceFacultatif | 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 | ExigenceNon pris en charge | Valeurs et limites | Par défaut— |
Champimage_urls | Typehttps_url|data_image_url[] | ExigenceObligatoire | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 Nombre maximal d’octets décodés: 20 971 520 Types MIME: image/jpeg, image/png, image/webp | Par défaut— |
first_frame_to_video · Obligatoire : image_urls
| Paramètre | Contrat |
|---|---|
Paramètrematerial_types | Contrattext, image |
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 ID sont exacts ; la capacité du fournisseur est distincte de l’admission des requêtes.
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_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\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 retourné et chaque index de sortie. content_url désigne seulement la première sortie; récupérez chaque chemin de contenu et ressource réels. Un GET du contenu sans index ne retourne pas toutes les sorties.
Consultez la tâche d’origine existante; ne soumettez jamais de nouveau un envoi dont l’état est inconnu.
| 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 éléments fournis ou valeur de paramètre invalides | É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 suivanteInterrogez l’identifiant d’origine retourné 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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Utilisez les chemins de méthode indiqués ci-dessus.