MiniMax-Hailuo-2.3
MiniMax Hailuo 2.3 erstellt Videos aus Text oder einem Startbild mit Steuerungen für Bewegung und Kameraführung. Wählen Sie sechs Sekunden in 768P oder 1080P oder zehn Sekunden in 768P für Figurendarbietungen, stilisierte Szenen und Produkteinstellungen, die sich prüfen und schneiden lassen.
- Ailoot · Videoerzeugung
POST /v1/videos/generationsMiniMax-Hailuo-2.3 - Ailoot Ultra · Video
POST /v1/videosMiniMax-Hailuo-2.3
Ü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.
MiniMax Hailuo 2.3 ist ein Videogenerierungsmodell mit Text-to-Video- und Image-to-Video-Modus. Es baut auf Hailuo 02 auf und konzentriert sich auf physische Handlung, Bildstil, Mikroausdrücke von Figuren und die Reaktion auf Bewegungsanweisungen. Liefern Sie eine schriftliche Szene für eine neue Einstellung oder nutzen Sie ein Startbild zur Festlegung der Eröffnungsansicht und beschreiben Sie die folgende Bewegung.
Körperliche Darbietung ist einer der zentralen Verbesserungsbereiche dieser Edition. Hailuo 2.3 zielt auf flüssigere, kontrolliertere Körperbewegungen, auch bei bewegter Kamera. Planen Sie die wichtige Handlung vor dekorativen Details. Eine Figur, die ein Objekt anhebt, sich einer anderen Person zuwendet oder durch einen Raum geht, gibt der Einstellung ein sichtbares Ereignis zur Beurteilung. Entscheiden Sie, welche Bewegung die Geschichte trägt, und halten Sie die umgebenden Anweisungen damit vereinbar.
Stilisierung ist ein weiterer Schwerpunkt. Das Modell unterstützt Anime und Illustration sowie Stile wie Tuschemalerei und Spiel-CG. Beschreiben Sie die gewünschte Bildgestaltung und halten Sie die Erscheinung mit der Szene konsistent. Gibt ein Startbild bereits einen Zeichenstil vor, führen Sie mit dem Text die Animation, statt eine konkurrierende Beschreibung des Figurendesigns einzuführen. Prüfen Sie im ganzen Clip, ob diese Gestaltung während der Bewegung verständlich bleibt.
Das Modell konzentriert sich auch auf Gesichtsdarbietung und subtile Ausdrucksänderungen. Bauen Sie eine Figureneinstellung um die entscheidende Reaktion auf: ein Objekt bemerken, neugierig werden oder mit einem kleinen Lächeln reagieren. Eine Nahansicht kann die Beurteilung erleichtern, während eine grosse Gestenabfolge davon ablenken kann. Prüfen Sie das Gesicht vor, während und nach der Reaktion, statt nur ein repräsentatives Standbild zu beurteilen.
Objektbewegung eignet sich für produktbezogene Szenen. Ein eigenes Briefing könnte eine kleine Keramikvase zeigen, die sich in warmem Seitenlicht dreht, während die Kamera langsam näher kommt. Benennen Sie Eigenschaften, die erkennbar bleiben müssen, etwa Silhouette, Rand und Oberflächenfinish. Prüfen Sie diese Details während der Bewegung, denn eine überzeugende Atmosphäre allein belegt keine originalgetreue Produktansicht.
Bei Text-to-Video kann die erforderliche Beschreibung bis zu 2’000 Zeichen enthalten. Nennen Sie Motiv, Handlung, Umgebung und Bildstil in einer zusammenhängenden Reihenfolge. Image-to-Video verlangt ein Startbild mit optionaler Beschreibung von bis zu 2’000 Zeichen. Das Bild legt die Eröffnungskomposition fest; bereiten Sie daher Motiv und Bildausschnitt vor der Bewegungsanfrage vor. Lassen Sie sichtbaren Platz, wo sich ein Arm, Objekt oder eine Figur bewegen muss.
Das Startbild akzeptiert JPG, JPEG, PNG oder WebP, muss kleiner als 20 MB sein, eine kurze Kante von mehr als 300 Pixeln und ein Seitenverhältnis zwischen 2:5 und 5:2 haben. Es kann als öffentliche Bild-URL oder Base64-Daten-URL geliefert werden. Wählen Sie ein klares Eröffnungsbild, statt darauf zu vertrauen, dass die Animation ein verdecktes Gesicht oder eine bereits abgeschnittene Handlung repariert.
Hailuo 2.3 generiert mit 24 Bildern pro Sekunde. Eine sechssekündige Einstellung kann 768P oder 1080P nutzen; eine zehnsekündige verwendet 768P. Standard sind sechs Sekunden und 768P. Wählen Sie die Länge für die gewünschte Handlung: Eine kurze Reaktion kann in eine kurze Einstellung passen, eine langsamere Bewegung braucht mehr Raum. Lesen Sie beim Einsetzen in den Schnitt die tatsächliche Breite und Höhe des fertigen Ergebnisses aus, da eine Auflösungsbezeichnung allein den Bildausschnitt nicht vollständig bestimmt.
Kameraführung kann Befehle in eckigen Klammern verwenden. Die verfügbaren Steuerungen umfassen seitliche Fahrt, Schwenk, Vorfahrt, vertikale Fahrt, Neigung, Zoom, Wackeln, Verfolgung und statische Einstellung. Ein Befehl wie [Push in] steuert die Annäherung; gemeinsam in einer Klammer gruppierte Befehle wirken gleichzeitig, hintereinander platzierte beschreiben eine Abfolge. MiniMax empfiehlt höchstens drei gleichzeitige Befehle. Halten Sie die Kamerabewegung mit der Motivhandlung vereinbar, damit das Hauptereignis leicht nachvollziehbar bleibt.
Automatische Prompt-Optimierung ist standardmässig aktiv und kann für engere Kontrolle über den gelieferten Wortlaut ausgeschaltet werden. Optionale schnelle Vorverarbeitung verkürzt die Optimierungszeit bei eingeschalteter Optimierung; sie ist eine andere Einstellung als die Wahl des Modells Hailuo 2.3 Fast. Standard-Hailuo 2.3 unterstützt beide Erstellungsmodi, während Fast die separate Image-to-Video-Edition ist. Wählen Sie die Edition danach, ob das Projekt mit Text allein oder einem vorhandenen Einzelbild beginnt.
Der Generierungsablauf liefert eine asynchrone Auftragskennung und meldet danach Vorbereitung, Warteschlange, Verarbeitung, Erfolg oder Fehler. Bei Erfolg liefert das Ergebnis eine Dateikennung und die tatsächlichen Videoabmessungen; das fertige Video wird zum Download abgerufen. Speichern Sie den Clip, solange seine Downloadadresse gültig ist. Die aktuelle Videodownload-Referenz des Herstellers nennt eine Lebensdauer von einer Stunde für die zurückgegebene Download-URL. Bewahren Sie für eine geschnittene Sequenz jede Einstellung mit Prompt und Startbild auf, damit die gewählte kreative Richtung bei Überarbeitungen nachvollziehbar bleibt.
Prüfen Sie Handlung, physische Kontinuität, Gesichts- oder Produktdetails, Bildstil und Kameraverhalten im gespeicherten Clip. Sehen Sie die ganze Einstellung an und kontrollieren Sie dann Anfang und Ende an den Verbindungen zu anderem Material. Enthält die Anfrage zu viele konkurrierende Bewegungen, vereinfachen Sie die Haupthandlung; ist das Ausgangsdesign unklar, verbessern Sie das Startbild. Wählen Sie eine Einstellung, die das beabsichtigte Ereignis vermittelt, und ergänzen Sie danach Sprechertext, Titel und Übergänge im Schnittablauf.
Ailoot · Videoerzeugung POST /v1/videos/generations MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Einstieg
MiniMax Hailuo 2.3 erstellt Videos aus Text oder einem Startbild mit Steuerungen für Bewegung und Kameraführung. Wählen Sie sechs Sekunden in 768P oder 1080P oder zehn Sekunden in 768P für Figurendarbietungen, stilisierte Szenen und Produkteinstellungen, die sich prüfen und schneiden lassen.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot · Videoerzeugung POST /v1/videos/generations
- Eingabe
text,image- Ausgabe
video- Ausgabeformat
- mp4
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits MiniMax-Hailuo-2.3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 Maximale Länge: 2'000 Einheit: Unicode-Zeichen | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits 6, 10 Bedingungen: 10 Sekunden erfordern 768P Einheit: Sekunden | Standard6 |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 768P, 1080P Bedingungen: 1080P erfordert 6 Sekunden | Standard768P |
Feldfirst_frame_image | Typhttps_url|data_image_url | AnforderungOptional | Werte und Limits Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/jpeg, image/png, image/webp Mindestabmessung (exklusiv): 300 Bereich der Seitenverhältnisse: 2:5, 5:2 | Standard— |
Feldprompt_optimizer | Typboolean | AnforderungOptional | Werte und Limits | Standard— |
Feldfast_pretreatment | Typboolean | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Bild zu Video · Erforderlich: prompt, first_frame_image
Text zu Video · Erforderlich: prompt
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext, image |
Parameterrequired | Vertragnull |
Parameteroptional_controls | Vertragnull |
Lebenszyklus: 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
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
Tarife
Ailoot-Methodentarife
POST /v1/videos/generations- Ausgabe
- $ 0.28 pro Video von 6 s bei 768p
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 abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
MiniMax-Hailuo-2.3
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationMiniMax-Hailuo-2.3 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 0.60 pro Aufruf |
MiniMax-Hailuo-2.3
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationMiniMax-Hailuo-2.3 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 1.20 pro Aufruf |
MiniMax-Hailuo-2.3
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationMiniMax-Hailuo-2.3 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 1.20 pro Aufruf |
Beispielanfragen
Ailoot · Videoerzeugung
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'Ergebnisse abrufen und speichern
Ailoot · Videoerzeugung
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Alle 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 jedes zurückgegebene Datenelement und jeden Ausgabeindex auf. content_url bezeichnet nur die erste Ausgabe; rufen Sie jeden tatsächlichen Inhaltspfad und jedes Asset ab. GET des Inhalts ohne index liefert nicht alle Ausgaben.
Wenn die ursprüngliche Antwort geprüft werden muss
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldobject | Typstring |
Feldmodel | Typstring |
Feldstatus | Typstring |
Feldcontent_url | Typsigned URL |
Felddata[] | Typsigned URL |
Feldusage | Typobject |
Feldresult_pending_check | Typboolean |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwort409 · video_not_ready | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID ab und beachten Sie Retry-After. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Aliasnamen
Modellaliasnamen
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Aliasnamen für Methodenpfade
/v1/videos/generations, /videos, /videos/generations
Zugehörige Aufrufer-IDs
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Einstieg
MiniMax Hailuo 2.3 erstellt Videos aus Text oder einem Startbild mit Steuerungen für Bewegung und Kameraführung. Wählen Sie sechs Sekunden in 768P oder 1080P oder zehn Sekunden in 768P für Figurendarbietungen, stilisierte Szenen und Produkteinstellungen, die sich prüfen und schneiden lassen.
- Zulässige Eingaben
- Text
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabe
text- Ausgabe
video- Ausgabeformat
- mp4
- Ausgabeanzahl
- Bis zu 1 Ausgabe
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits MiniMax-Hailuo-2.3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 Maximale Länge: 2'000 Bedingungen: Für 768P: höchstens 2000 Unicode-Codepunkte. Für 1080P: weniger als 200 Unicode-Codepunkte (maximal 199). Die Textbeschreibung muss Text enthalten, der nicht ausschliesslich aus Leerraum besteht. Einheit: Unicode-Zeichen | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 6 Einheit: Sekunden | Standard— |
Feldresolution | Typstring | AnforderungErforderlich | Werte und Limits 768P, 1080P | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Erforderlich: prompt
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration, resolution |
Parameterother_options | Vertragfalse |
Parameterduration | Vertrag6 |
Parameterresolution | Vertrag768P, 1080P |
Parameterprompt_max_characters | Vertrag2000 |
Parametermaterial_types | Vertragtext |
Parameterprompt_max_characters_by_resolution | Vertrag{"768P":2000,"1080P":199} |
Methodenaliasnamen: /v1/videos/generations, /videos, /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/videos/generations/{request_id}/content
Erstellen Sie einmal und speichern Sie die zurückgegebene ID.
Fragen Sie den ursprünglichen Status ab; bewahren Sie jedes fertiggestellte Asset und dessen Dauer auf.
Tarife
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
Ailoot-Tarife
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Nominelle Clipdauer, Sekunden | Auflösung | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Nominelle Clipdauer, Sekunden— | Auflösung— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Tokens Ausgabe · Ausgabetoken — / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · Cache schreiben — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationUltra | Tarifstaffel— | Nominelle Clipdauer, Sekunden6 | Auflösung1080P | Abrechnungseinheitpro Ausgabeclip mit nominell 6s | Gebühr Ausgabe · Nomineller 6s-Ausgabeclip $1.2 pro Ausgabeclip mit nominell 6s |
| KonfigurationUltra | Tarifstaffel— | Nominelle Clipdauer, Sekunden6 | Auflösung768P | Abrechnungseinheitpro Ausgabeclip mit nominell 6s | Gebühr Ausgabe · Nomineller 6s-Ausgabeclip $0.6 pro Ausgabeclip mit nominell 6s |
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 abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
MiniMax-Hailuo-2.3
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationMiniMax-Hailuo-2.3 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 0.60 pro Aufruf |
MiniMax-Hailuo-2.3
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationMiniMax-Hailuo-2.3 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 1.20 pro Aufruf |
MiniMax-Hailuo-2.3
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationMiniMax-Hailuo-2.3 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabe $ 0.00 pro Aufruf Ausgabe · Ausgabe $ 1.20 pro Aufruf |
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Alle fertiggestellten Dateien speichern
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if 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")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
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")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Das abgeschlossene data[] enthält alle signierten Inhalts-URLs der Ihnen zugeordneten Ausgaben. Rufen Sie jede zurückgegebene URL ab oder verwenden Sie den Inhaltsendpunkt mit index auf einem tatsächlichen Ausgabeindex. Ein fehlgeschlagener ursprünglicher Auftrag kann charge_pending_check zurückgeben; prüfen Sie diesen ursprünglichen Auftrag, statt ihn erneut zu erstellen.
Wenn die ursprüngliche Antwort geprüft werden muss
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
Maximale Anzahl der Ausgaben: 1.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldobject | Typstring |
Feldmodel | Typstring |
Feldstatus | Typstring |
Felddata[] | Typsigned content URL |
Feldcharge_pending_check | Typboolean |
Felderror.code | Typstring |
Felderror.message | Typstring |
Feldrequested_nominal_duration_seconds | Typinteger |
Feldmeasured_duration_seconds | Typnumber |
Feldwidth | Typinteger |
Feldheight | Typinteger |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwort409 · video_not_ready | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID ab und beachten Sie Retry-After. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Aliasnamen
Modellaliasnamen
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Aliasnamen für Methodenpfade
/v1/videos/generations, /videos, /videos/generations
Zugehörige Aufrufer-IDs
FAQ · MiniMax-Hailuo-2.3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:text,image→videoPOST /v1/videos·MiniMax-Hailuo-2.3:text→video- Welche Felder verwendet die Anfrage?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:model,prompt,duration,resolution,first_frame_image,prompt_optimizer,fast_pretreatmentPOST /v1/videos·MiniMax-Hailuo-2.3:model,prompt,duration,resolution- Welche Grenzen gelten?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:prompt.maximum_length:2000POST /v1/videos·MiniMax-Hailuo-2.3:prompt.maximum_length:2000