MiniMax: S2V 01
S2V 01 nutzt eine Porträtreferenz als Orientierung für eine Figur in einem neu erzeugten Video. Stellen Sie ein klares Gesichtsbild bereit und beschreiben Sie Szene und Handlung; im Herstellerablauf mit Motivreferenz dient das Bild als Figurenreferenz.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
S2V 01 ist MiniMax’ Videomodell mit Motivreferenz. Das bereitgestellte Bild gibt das Aussehen einer Figur vor, während der Text Videoszene und Handlung beschreibt. Der dokumentierte Referenztyp ist das Gesicht einer Person; bereiten Sie das Porträt deshalb als Vorlage für das Aussehen der Figur vor, die in der erzeugten Sequenz erscheinen soll.
Wählen Sie eine Referenz mit klarem und gut unterscheidbarem gewünschtem Gesicht. Verdecken Sie prägende Merkmale nicht durch eine Hand, ein großes Zubehörteil oder starken Beschnitt, wenn diese Merkmale für das Ergebnis wichtig sind. Behalten Sie das Porträt über zusammengehörige Aufnahmen hinweg bei, damit die verwendete Figurenvorlage bekannt bleibt. Die Referenz liefert Aussehensinformationen; erklären Sie im Prompt die Szene, die die Figur ausführen soll.
Das Motivreferenzschema des Herstellers akzeptiert ein Bild im Array der Referenzbilder. Unterstützte Formate sind JPG, JPEG, PNG und WebP mit einer Dateigröße unter 20 MB. Die kürzere Seite muss 300 Pixel überschreiten, und das Seitenverhältnis muss zwischen 2:5 und 5:2 liegen. Bewahren Sie genau diese Bilddatei zusammen mit dem Generierungsdatensatz auf, statt bei einem späteren Vergleich ein anderes Porträt einzusetzen.
Beschreiben Sie eine Szene mit klarer Rolle der referenzierten Person. Beispielsweise könnte die Figur eine ruhige Werkstatt betreten, ein Objekt auf dem Tisch ansehen und daneben stehen bleiben. Bestimmen Sie Handlung, Umgebung und den für die fertige Aufnahme wichtigen Blickwinkel. Richten Sie Bildausschnitt und Bewegung nach der Sichtbarkeit des Gesichts aus, wenn es erkennbar bleiben muss.
Die Textbeschreibung unterstützt bis zu 2.000 Zeichen. Nutzen Sie sie für konkrete Anweisungen: Was tut die Figur, was umgibt sie und was soll die Schlussansicht zeigen? Beschreiben Sie Kleidung oder Szenendetails, wenn sie für die Geschichte wichtig sind, und prüfen Sie danach, wie das erzeugte Video diese mit der bereitgestellten Figurenvorlage verbindet. Unterscheiden Sie die Referenzrolle von einer Anfrage, den gesamten Porträthintergrund als Anfangsbild nachzubilden.
Automatische Promptoptimierung ist dokumentiert und standardmäßig eingeschaltet. Sie kann zur genaueren Steuerung der schriftlichen Beschreibung ausgeschaltet werden. Bewahren Sie diese Auswahl beim Vergleich unterschiedlicher Szenen zusammen mit Text und Porträt auf. Behalten Sie bei der Untersuchung eines Ähnlichkeitsproblems den Szenenauftrag beim Vergleich einer verbesserten Referenz bei; behalten Sie bei der Untersuchung der Handlung die Referenz beim Überarbeiten der Bewegungsbeschreibung bei.
Der Herstellerablauf gibt eine Aufgabenkennung zurück, bevor das Video fertig ist. Erhalten Sie die ursprüngliche Kennung während Status- und Ergebnisschritten und speichern Sie dann den fertigen Clip zur Prüfung und Bearbeitung. Bewahren Sie Porträt, Prompt und entstandenes Video als einen Datensatz auf, damit eine spätere Aufnahme mit dem tatsächlichen Material verglichen werden kann, das das frühere Ergebnis geprägt hat.
Prüfen Sie die Figur während der gesamten Sequenz einschließlich Drehungen, Gesten und Änderungen des Bildausschnitts. Prüfen Sie Gesichtskonsistenz, Erkennbarkeit der gewünschten Handlung und die Beziehung zwischen Figur und Szenenobjekten. Wählen Sie den Clip, der dem Aufnahmezweck am besten dient, und bestimmen Sie konkrete Abweichungen vor einer Eingabeüberarbeitung. Ein Ablauf mit wiederkehrender Figur profitiert vom direkten Vergleich mehrerer fertiger Aufnahmen mit derselben Porträtreferenz und einer klaren Aufzeichnung jeder Szenenbeschreibung.
Ailoot Ultra · Videogenerierung POST /v1/videos minimaxi-s2v-01
minimaxi-s2v-01Start
S2V 01 nutzt eine Porträtreferenz als Orientierung für eine Figur in einem neu erzeugten Video. Stellen Sie ein klares Gesichtsbild bereit und beschreiben Sie Szene und Handlung; im Herstellerablauf mit Motivreferenz dient das Bild als Figurenreferenz.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videogenerierung POST /v1/videos
- Eingabetypen
text,image- Ausgabetypen
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits minimaxi-s2v-01 Bedingungen: Verwenden Sie die genaue Ailoot-Modellauswahl. | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Bedingungen: Beschreiben Sie die Szene und die Bewegung. | Standard— |
Feldend_image | Typstring | AnforderungOptional | Werte und Limits Bedingungen: Ein Endframe gilt nur in einem unterstützten Bildeingabemodus. | Standard— |
Feldimage | Typstring or array<string> | AnforderungOptional | Werte und Limits Bedingungen: Verwenden Sie eine tatsächliche, öffentlich erreichbare Bild-URL oder eine base64-Bildzeichenfolge; eine maximale Bildanzahl wird hier nicht zugesichert. | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragend_image, image |
Parametermaterial_types | Vertragtext, image |
Parameterconditions | VertragVerwenden Sie die genaue Ailoot-Modellauswahl., Beschreiben Sie die Szene und die Bewegung., Ein Endframe gilt nur in einem unterstützten Bildeingabemodus., Verwenden Sie eine tatsächliche, öffentlich erreichbare Bild-URL oder eine base64-Bildzeichenfolge; eine maximale Bildanzahl wird hier nicht zugesichert. |
Methodenaliasnamen: /v1/videos/generations
Lebenszyklus: 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}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungsmenge | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungsmenge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationPro Anfrage | Tarifstaffel— | Prognostizierte Menge— | Abrechnungsmengeeine Anfrage | Gebühr Eingabe · Schätzung nur zum Vergleich $1.4 pro Anfrage |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungsmenge— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $1.4 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videogenerierung
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-s2v-01",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.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)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
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"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
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"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Ergebnisse abrufen und speichern
Ailoot Ultra · Videogenerierung
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie die vollständige Antwort und die Header, ursprüngliche Kennungen, jede tatsächliche Ausgabe sowie alle Verbrauchs- und Abrechnungsfelder auf. Speichern Sie jedes eindeutige, Ihnen zugeordnete Asset und bewahren Sie jede darauf verweisende Rolle auf.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die zurückgegebene öffentliche Aufgaben- oder Vorgangs-ID und sämtliche Header auf. Lesen Sie ausschließlich die ursprüngliche Aufgabe aus; unknown oder result_pending_check berechtigt nicht zu einer weiteren Erstellung.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldpolling_url | Typstring |
Feldprovider_task_id | Typstring |
Feldtask_id | Typstring |
Feldstatus | Typstring |
Feldvideo_url | Typstring |
Aliasnamen
Modellaliasnamen
Ailoot Ultra minimaxi-s2v-01
Aliasnamen für Methodenpfade
/v1/videos/generations
Zugehörige Aufrufer-IDs
FAQ · MiniMax: S2V 01
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·minimaxi-s2v-01:text,image→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·minimaxi-s2v-01:model,prompt,end_image,image