S2V 01 est le modèle vidéo de MiniMax utilisant une référence du sujet. L’image fournie guide l’apparence d’un personnage, tandis que le texte décrit la scène vidéo et l’action. Le type de référence documenté est le visage d’une personne : préparez donc le portrait comme un repère d’identité pour le personnage à placer dans la séquence générée.
Choisissez une référence où le visage souhaité est net et facile à distinguer. Évitez de masquer les traits caractéristiques derrière une main, un accessoire volumineux ou un cadrage très serré lorsque ces traits comptent pour le résultat. Conservez le même portrait entre les plans liés afin de toujours connaître la source qui guide le personnage. La référence renseigne son apparence ; utilisez le prompt pour expliquer la scène que le personnage doit jouer.
Le schéma de référence du sujet du fabricant accepte une seule image dans le tableau des images de référence. Les formats pris en charge sont JPG, JPEG, PNG et WebP, avec une taille de fichier inférieure à 20 MB. Le côté le plus court doit dépasser 300 pixels, et le rapport largeur/hauteur doit se situer entre 2:5 et 5:2. Conservez le fichier image exact avec l’enregistrement de génération plutôt que de lui substituer un autre portrait lors d’une comparaison ultérieure.
Décrivez une scène donnant un rôle clair à la personne de référence. Le personnage peut, par exemple, entrer dans un atelier calme, regarder un objet sur la table et s’arrêter à côté. Précisez l’action, le décor et le point de vue qui comptent pour le plan terminé. Si le visage doit rester lisible, organisez le cadrage et le mouvement autour de cette exigence.
La description textuelle accepte jusqu’à 2 000 caractères. Consacrez-les à des instructions concrètes : ce que fait le personnage, ce qui l’entoure et ce que doit montrer la vue finale. Décrivez les vêtements ou les détails du décor lorsqu’ils comptent pour l’histoire, puis examinez la manière dont la vidéo générée les combine avec la référence d’identité fournie. Distinguez le rôle de cette référence d’une demande de reproduire tout l’arrière-plan du portrait comme première image.
L’optimisation automatique du prompt est documentée et activée par défaut. Elle peut être désactivée lorsqu’un contrôle plus précis de la description écrite est nécessaire. Conservez ce choix avec le texte et le portrait lorsque vous comparez différentes scènes. Pour examiner un problème de ressemblance, gardez les instructions de scène constantes tout en comparant une référence améliorée ; pour examiner l’action, gardez la référence constante tout en révisant la description du mouvement.
Le flux du fabricant renvoie un identifiant de tâche avant que la vidéo soit terminée. Conservez cet identifiant original pendant les étapes de consultation du statut et du résultat, puis enregistrez le clip terminé pour l’examiner et le monter. Gardez le portrait, le prompt et la vidéo obtenue dans un même enregistrement afin qu’un plan ultérieur puisse être comparé aux éléments réels qui ont guidé le résultat précédent.
Examinez le personnage tout au long de la séquence, y compris les rotations, les gestes et les changements de cadrage. Vérifiez la cohérence du visage, la lisibilité de l’action prévue et la relation entre le personnage et les objets de la scène. Choisissez le clip qui sert le mieux l’objectif du plan et identifiez tout écart concret avant de réviser l’entrée. Pour un personnage récurrent, il est utile d’examiner plusieurs plans terminés côte à côte, avec le même portrait de référence et un enregistrement clair de chaque description de scène.
", "aboutText": "S2V 01 est le modèle vidéo de MiniMax utilisant une référence du sujet. L’image fournie guide l’apparence d’un personnage, tandis que le texte décrit la scène vidéo et l’action. Le type de référence documenté est le visage d’une personne : préparez donc le portrait comme un repère d’identité pour le personnage à placer dans la séquence générée.\n\nChoisissez une référence où le visage souhaité est net et facile à distinguer. Évitez de masquer les traits caractéristiques derrière une main, un accessoire volumineux ou un cadrage très serré lorsque ces traits comptent pour le résultat. Conservez le même portrait entre les plans liés afin de toujours connaître la source qui guide le personnage. La référence renseigne son apparence ; utilisez le prompt pour expliquer la scène que le personnage doit jouer.\n\nLe schéma de référence du sujet du fabricant accepte une seule image dans le tableau des images de référence. Les formats pris en charge sont JPG, JPEG, PNG et WebP, avec une taille de fichier inférieure à 20 MB. Le côté le plus court doit dépasser 300 pixels, et le rapport largeur/hauteur doit se situer entre 2:5 et 5:2. Conservez le fichier image exact avec l’enregistrement de génération plutôt que de lui substituer un autre portrait lors d’une comparaison ultérieure.\n\nDécrivez une scène donnant un rôle clair à la personne de référence. Le personnage peut, par exemple, entrer dans un atelier calme, regarder un objet sur la table et s’arrêter à côté. Précisez l’action, le décor et le point de vue qui comptent pour le plan terminé. Si le visage doit rester lisible, organisez le cadrage et le mouvement autour de cette exigence.\n\nLa description textuelle accepte jusqu’à 2 000 caractères. Consacrez-les à des instructions concrètes : ce que fait le personnage, ce qui l’entoure et ce que doit montrer la vue finale. Décrivez les vêtements ou les détails du décor lorsqu’ils comptent pour l’histoire, puis examinez la manière dont la vidéo générée les combine avec la référence d’identité fournie. Distinguez le rôle de cette référence d’une demande de reproduire tout l’arrière-plan du portrait comme première image.\n\nL’optimisation automatique du prompt est documentée et activée par défaut. Elle peut être désactivée lorsqu’un contrôle plus précis de la description écrite est nécessaire. Conservez ce choix avec le texte et le portrait lorsque vous comparez différentes scènes. Pour examiner un problème de ressemblance, gardez les instructions de scène constantes tout en comparant une référence améliorée ; pour examiner l’action, gardez la référence constante tout en révisant la description du mouvement.\n\nLe flux du fabricant renvoie un identifiant de tâche avant que la vidéo soit terminée. Conservez cet identifiant original pendant les étapes de consultation du statut et du résultat, puis enregistrez le clip terminé pour l’examiner et le monter. Gardez le portrait, le prompt et la vidéo obtenue dans un même enregistrement afin qu’un plan ultérieur puisse être comparé aux éléments réels qui ont guidé le résultat précédent.\n\nExaminez le personnage tout au long de la séquence, y compris les rotations, les gestes et les changements de cadrage. Vérifiez la cohérence du visage, la lisibilité de l’action prévue et la relation entre le personnage et les objets de la scène. Choisissez le clip qui sert le mieux l’objectif du plan et identifiez tout écart concret avant de réviser l’entrée. Pour un personnage récurrent, il est utile d’examiner plusieurs plans terminés côte à côte, avec le même portrait de référence et un enregistrement clair de chaque description de scène.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7bd92b997357285ad5d0d509b46d75488ef44b289aac33f78ce5219f24c09cb2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ch", "methods": [ { "html": "minimaxi-s2v-01S2V 01 utilise un portrait de référence pour guider un personnage dans une vidéo nouvellement générée. Fournissez une image nette du visage et décrivez la scène et l’action ; dans le flux de référence du sujet du fabricant, cette image sert de référence pour le personnage.
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.
S2V 01 est le modèle vidéo de MiniMax utilisant une référence du sujet. L’image fournie guide l’apparence d’un personnage, tandis que le texte décrit la scène vidéo et l’action. Le type de référence documenté est le visage d’une personne : préparez donc le portrait comme un repère d’identité pour le personnage à placer dans la séquence générée.
Choisissez une référence où le visage souhaité est net et facile à distinguer. Évitez de masquer les traits caractéristiques derrière une main, un accessoire volumineux ou un cadrage très serré lorsque ces traits comptent pour le résultat. Conservez le même portrait entre les plans liés afin de toujours connaître la source qui guide le personnage. La référence renseigne son apparence ; utilisez le prompt pour expliquer la scène que le personnage doit jouer.
Le schéma de référence du sujet du fabricant accepte une seule image dans le tableau des images de référence. Les formats pris en charge sont JPG, JPEG, PNG et WebP, avec une taille de fichier inférieure à 20 MB. Le côté le plus court doit dépasser 300 pixels, et le rapport largeur/hauteur doit se situer entre 2:5 et 5:2. Conservez le fichier image exact avec l’enregistrement de génération plutôt que de lui substituer un autre portrait lors d’une comparaison ultérieure.
Décrivez une scène donnant un rôle clair à la personne de référence. Le personnage peut, par exemple, entrer dans un atelier calme, regarder un objet sur la table et s’arrêter à côté. Précisez l’action, le décor et le point de vue qui comptent pour le plan terminé. Si le visage doit rester lisible, organisez le cadrage et le mouvement autour de cette exigence.
La description textuelle accepte jusqu’à 2 000 caractères. Consacrez-les à des instructions concrètes : ce que fait le personnage, ce qui l’entoure et ce que doit montrer la vue finale. Décrivez les vêtements ou les détails du décor lorsqu’ils comptent pour l’histoire, puis examinez la manière dont la vidéo générée les combine avec la référence d’identité fournie. Distinguez le rôle de cette référence d’une demande de reproduire tout l’arrière-plan du portrait comme première image.
L’optimisation automatique du prompt est documentée et activée par défaut. Elle peut être désactivée lorsqu’un contrôle plus précis de la description écrite est nécessaire. Conservez ce choix avec le texte et le portrait lorsque vous comparez différentes scènes. Pour examiner un problème de ressemblance, gardez les instructions de scène constantes tout en comparant une référence améliorée ; pour examiner l’action, gardez la référence constante tout en révisant la description du mouvement.
Le flux du fabricant renvoie un identifiant de tâche avant que la vidéo soit terminée. Conservez cet identifiant original pendant les étapes de consultation du statut et du résultat, puis enregistrez le clip terminé pour l’examiner et le monter. Gardez le portrait, le prompt et la vidéo obtenue dans un même enregistrement afin qu’un plan ultérieur puisse être comparé aux éléments réels qui ont guidé le résultat précédent.
Examinez le personnage tout au long de la séquence, y compris les rotations, les gestes et les changements de cadrage. Vérifiez la cohérence du visage, la lisibilité de l’action prévue et la relation entre le personnage et les objets de la scène. Choisissez le clip qui sert le mieux l’objectif du plan et identifiez tout écart concret avant de réviser l’entrée. Pour un personnage récurrent, il est utile d’examiner plusieurs plans terminés côte à côte, avec le même portrait de référence et un enregistrement clair de chaque description de scène.
POST /v1/videostext, imagevideo| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites minimaxi-s2v-01 Conditions: Utilisez le sélecteur exact de modèle Ailoot. | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Conditions: Décrivez la scène et le mouvement. | Par défaut— |
Champend_image | Typestring | ExigenceFacultatif | Valeurs et limites Conditions: Une image de fin s’applique uniquement dans un mode d’entrée image pris en charge. | Par défaut— |
Champimage | Typestring or array<string> | ExigenceFacultatif | Valeurs et limites Conditions: Utilisez une URL d’image réelle et accessible publiquement ou une chaîne d’image base64 ; aucun nombre maximal d’images n’est affirmé ici. | Par défaut— |
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètreoptional | Contratend_image, image |
Paramètrematerial_types | Contrattext, image |
Paramètreconditions | ContratUtilisez le sélecteur exact de modèle Ailoot., Décrivez la scène et le mouvement., Une image de fin s’applique uniquement dans un mode d’entrée image pris en charge., Utilisez une URL d’image réelle et accessible publiquement ou une chaîne d’image base64 ; aucun nombre maximal d’images n’est affirmé ici. |
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 | Quantité facturée | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Quantité facturée— | 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 |
| ConfigurationPar requête | Barème tarifaire— | Quantité prévisionnelle— | Quantité facturéeune requête | Coût Entrée · Estimation à des fins de comparaison uniquement $1.4 par requête |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Quantité facturée— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $1.4 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 →
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON'\n{\n "model": "minimaxi-s2v-01",\n "prompt": "A cat is walking on grass.",\n "image": "YOUR_ACCESSIBLE_IMAGE_URL"\n}\nJSON\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# Create once; retain id, polling_url, original task identifiers and every 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 |
Ailoot Ultra minimaxi-s2v-01
/v1/videos/generations