S2V 01 è il modello video di MiniMax basato su un soggetto di riferimento. L’immagine fornita guida l’aspetto di un personaggio, mentre il testo descrive la scena video e l’azione. Il tipo di riferimento documentato è il viso di una persona: preparate quindi il ritratto come guida all’identità visiva del personaggio da collocare nella sequenza generata.
Scegliete un riferimento in cui il viso desiderato sia chiaro e facile da distinguere. Evitate di nascondere caratteristiche distintive dietro una mano, un grande accessorio o un ritaglio marcato quando contano per il risultato. Mantenete coerente il ritratto tra inquadrature correlate, affinché la fonte usata per guidare il personaggio resti nota. Il riferimento fornisce informazioni sull’aspetto; usate il prompt per spiegare la scena che il personaggio deve interpretare.
Lo schema del produttore per il soggetto di riferimento accetta una sola immagine nell’array delle immagini di riferimento. I formati supportati sono JPG, JPEG, PNG e WebP, con dimensioni del file inferiori a 20 MB. Il lato più corto deve superare 300 pixel e il rapporto d’aspetto deve essere compreso tra 2:5 e 5:2. Conservate il file esatto dell’immagine insieme al record di generazione, anziché sostituirlo con un ritratto diverso durante un confronto successivo.
Descrivete una scena con un ruolo chiaro per la persona di riferimento. Ad esempio, il personaggio può entrare in un laboratorio tranquillo, guardare un oggetto sul tavolo e fermarsi accanto a esso. Precisate l’azione, l’ambientazione e il punto di vista importanti per l’inquadratura finita. Se il viso deve restare leggibile, pianificate l’inquadratura e il movimento intorno a quel requisito.
La descrizione testuale supporta fino a 2 000 caratteri. Usateli per istruzioni concrete: che cosa fa il personaggio, che cosa lo circonda e che cosa deve mostrare la vista finale. Descrivete abbigliamento o dettagli della scena quando sono importanti per la storia, poi esaminate come il video generato li combini con il riferimento di identità fornito. Mantenete distinto il ruolo del riferimento da una richiesta di riprodurre l’intero sfondo del ritratto come fotogramma iniziale.
L’ottimizzazione automatica del prompt è documentata e attivata per impostazione predefinita. Può essere disattivata quando serve un controllo più preciso della descrizione scritta. Preservate questa scelta insieme al testo e al ritratto quando confrontate scene diverse. Per indagare un problema di somiglianza, mantenete costante la descrizione della scena confrontando un riferimento migliorato; per indagare l’azione, mantenete costante il riferimento rivedendo la descrizione del movimento.
Il processo del produttore restituisce un identificatore dell’attività prima che il video sia completo. Conservate l’identificatore originale durante le fasi di stato e risultato, poi salvate il filmato completato per l’esame e il montaggio. Conservate ritratto, prompt e video risultante in un unico record, affinché un’inquadratura successiva possa essere confrontata con i materiali effettivi che hanno guidato il risultato precedente.
Esaminate il personaggio per tutta la sequenza, includendo rotazioni, gesti e cambiamenti di inquadratura. Verificate la coerenza del viso, la leggibilità dell’azione desiderata e la relazione tra il personaggio e gli oggetti della scena. Selezionate il filmato che serve meglio allo scopo dell’inquadratura e identificate eventuali discrepanze concrete prima di rivedere l’input. Un processo con un personaggio ricorrente beneficia dell’esame di più inquadrature finite affiancate, usando lo stesso ritratto di riferimento e un record chiaro di ogni descrizione della scena.
", "aboutText": "S2V 01 è il modello video di MiniMax basato su un soggetto di riferimento. L’immagine fornita guida l’aspetto di un personaggio, mentre il testo descrive la scena video e l’azione. Il tipo di riferimento documentato è il viso di una persona: preparate quindi il ritratto come guida all’identità visiva del personaggio da collocare nella sequenza generata.\n\nScegliete un riferimento in cui il viso desiderato sia chiaro e facile da distinguere. Evitate di nascondere caratteristiche distintive dietro una mano, un grande accessorio o un ritaglio marcato quando contano per il risultato. Mantenete coerente il ritratto tra inquadrature correlate, affinché la fonte usata per guidare il personaggio resti nota. Il riferimento fornisce informazioni sull’aspetto; usate il prompt per spiegare la scena che il personaggio deve interpretare.\n\nLo schema del produttore per il soggetto di riferimento accetta una sola immagine nell’array delle immagini di riferimento. I formati supportati sono JPG, JPEG, PNG e WebP, con dimensioni del file inferiori a 20 MB. Il lato più corto deve superare 300 pixel e il rapporto d’aspetto deve essere compreso tra 2:5 e 5:2. Conservate il file esatto dell’immagine insieme al record di generazione, anziché sostituirlo con un ritratto diverso durante un confronto successivo.\n\nDescrivete una scena con un ruolo chiaro per la persona di riferimento. Ad esempio, il personaggio può entrare in un laboratorio tranquillo, guardare un oggetto sul tavolo e fermarsi accanto a esso. Precisate l’azione, l’ambientazione e il punto di vista importanti per l’inquadratura finita. Se il viso deve restare leggibile, pianificate l’inquadratura e il movimento intorno a quel requisito.\n\nLa descrizione testuale supporta fino a 2 000 caratteri. Usateli per istruzioni concrete: che cosa fa il personaggio, che cosa lo circonda e che cosa deve mostrare la vista finale. Descrivete abbigliamento o dettagli della scena quando sono importanti per la storia, poi esaminate come il video generato li combini con il riferimento di identità fornito. Mantenete distinto il ruolo del riferimento da una richiesta di riprodurre l’intero sfondo del ritratto come fotogramma iniziale.\n\nL’ottimizzazione automatica del prompt è documentata e attivata per impostazione predefinita. Può essere disattivata quando serve un controllo più preciso della descrizione scritta. Preservate questa scelta insieme al testo e al ritratto quando confrontate scene diverse. Per indagare un problema di somiglianza, mantenete costante la descrizione della scena confrontando un riferimento migliorato; per indagare l’azione, mantenete costante il riferimento rivedendo la descrizione del movimento.\n\nIl processo del produttore restituisce un identificatore dell’attività prima che il video sia completo. Conservate l’identificatore originale durante le fasi di stato e risultato, poi salvate il filmato completato per l’esame e il montaggio. Conservate ritratto, prompt e video risultante in un unico record, affinché un’inquadratura successiva possa essere confrontata con i materiali effettivi che hanno guidato il risultato precedente.\n\nEsaminate il personaggio per tutta la sequenza, includendo rotazioni, gesti e cambiamenti di inquadratura. Verificate la coerenza del viso, la leggibilità dell’azione desiderata e la relazione tra il personaggio e gli oggetti della scena. Selezionate il filmato che serve meglio allo scopo dell’inquadratura e identificate eventuali discrepanze concrete prima di rivedere l’input. Un processo con un personaggio ricorrente beneficia dell’esame di più inquadrature finite affiancate, usando lo stesso ritratto di riferimento e un record chiaro di ogni descrizione della scena.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c44ae9472249b1ad0f2da02be71160b556f776350b73fc3f0b4ab6fbb2b559e2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "minimaxi-s2v-01S2V 01 usa un ritratto di riferimento per guidare un personaggio in un video appena generato. Fornite un’immagine chiara del viso e descrivete la scena e l’azione; il processo del produttore basato su un soggetto di riferimento tratta l’immagine come riferimento del personaggio.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
S2V 01 è il modello video di MiniMax basato su un soggetto di riferimento. L’immagine fornita guida l’aspetto di un personaggio, mentre il testo descrive la scena video e l’azione. Il tipo di riferimento documentato è il viso di una persona: preparate quindi il ritratto come guida all’identità visiva del personaggio da collocare nella sequenza generata.
Scegliete un riferimento in cui il viso desiderato sia chiaro e facile da distinguere. Evitate di nascondere caratteristiche distintive dietro una mano, un grande accessorio o un ritaglio marcato quando contano per il risultato. Mantenete coerente il ritratto tra inquadrature correlate, affinché la fonte usata per guidare il personaggio resti nota. Il riferimento fornisce informazioni sull’aspetto; usate il prompt per spiegare la scena che il personaggio deve interpretare.
Lo schema del produttore per il soggetto di riferimento accetta una sola immagine nell’array delle immagini di riferimento. I formati supportati sono JPG, JPEG, PNG e WebP, con dimensioni del file inferiori a 20 MB. Il lato più corto deve superare 300 pixel e il rapporto d’aspetto deve essere compreso tra 2:5 e 5:2. Conservate il file esatto dell’immagine insieme al record di generazione, anziché sostituirlo con un ritratto diverso durante un confronto successivo.
Descrivete una scena con un ruolo chiaro per la persona di riferimento. Ad esempio, il personaggio può entrare in un laboratorio tranquillo, guardare un oggetto sul tavolo e fermarsi accanto a esso. Precisate l’azione, l’ambientazione e il punto di vista importanti per l’inquadratura finita. Se il viso deve restare leggibile, pianificate l’inquadratura e il movimento intorno a quel requisito.
La descrizione testuale supporta fino a 2 000 caratteri. Usateli per istruzioni concrete: che cosa fa il personaggio, che cosa lo circonda e che cosa deve mostrare la vista finale. Descrivete abbigliamento o dettagli della scena quando sono importanti per la storia, poi esaminate come il video generato li combini con il riferimento di identità fornito. Mantenete distinto il ruolo del riferimento da una richiesta di riprodurre l’intero sfondo del ritratto come fotogramma iniziale.
L’ottimizzazione automatica del prompt è documentata e attivata per impostazione predefinita. Può essere disattivata quando serve un controllo più preciso della descrizione scritta. Preservate questa scelta insieme al testo e al ritratto quando confrontate scene diverse. Per indagare un problema di somiglianza, mantenete costante la descrizione della scena confrontando un riferimento migliorato; per indagare l’azione, mantenete costante il riferimento rivedendo la descrizione del movimento.
Il processo del produttore restituisce un identificatore dell’attività prima che il video sia completo. Conservate l’identificatore originale durante le fasi di stato e risultato, poi salvate il filmato completato per l’esame e il montaggio. Conservate ritratto, prompt e video risultante in un unico record, affinché un’inquadratura successiva possa essere confrontata con i materiali effettivi che hanno guidato il risultato precedente.
Esaminate il personaggio per tutta la sequenza, includendo rotazioni, gesti e cambiamenti di inquadratura. Verificate la coerenza del viso, la leggibilità dell’azione desiderata e la relazione tra il personaggio e gli oggetti della scena. Selezionate il filmato che serve meglio allo scopo dell’inquadratura e identificate eventuali discrepanze concrete prima di rivedere l’input. Un processo con un personaggio ricorrente beneficia dell’esame di più inquadrature finite affiancate, usando lo stesso ritratto di riferimento e un record chiaro di ogni descrizione della scena.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti minimaxi-s2v-01 Condizioni: Usa il selettore esatto del modello Ailoot. | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Descrivi la scena e il movimento. | Predefinito— |
Campoend_image | Tipostring | RequisitoFacoltativo | Valori e limiti Condizioni: Un fotogramma finale si applica solo in una modalità di input con immagini supportata. | Predefinito— |
Campoimage | Tipostring or array<string> | RequisitoFacoltativo | Valori e limiti Condizioni: Usa un URL reale di un'immagine raggiungibile pubblicamente oppure una stringa di immagine in base64; qui non viene dichiarato un numero massimo di immagini. | Predefinito— |
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametrooptional | Contrattoend_image, image |
Parametromaterial_types | Contrattotext, image |
Parametroconditions | ContrattoUsa il selettore esatto del modello Ailoot., Descrivi la scena e il movimento., Un fotogramma finale si applica solo in una modalità di input con immagini supportata., Usa un URL reale di un'immagine raggiungibile pubblicamente oppure una stringa di immagine in base64; qui non viene dichiarato un numero massimo di immagini. |
Alias del metodo: /v1/videos/generations
Ciclo di vita: 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}
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Quantità fatturata | Costo |
|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Quantità fatturata— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePer richiesta | Listino delle tariffe— | Quantità prevista— | Quantità fatturatauna richiesta | Costo Input · Stima solo a fini di confronto $1.4 per richiesta |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Quantità fatturata— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $1.4 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
# 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}Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.
Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result_pending_check non autorizza un'altra creazione.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campotask_id | Tipostring |
Campostatus | Tipostring |
Campovideo_url | Tipostring |
Ailoot Ultra minimaxi-s2v-01
/v1/videos/generations