MiniMax: H3
MiniMax H3 erzeugt kurze Videos mit nativem Stereo-Audio aus Text, Einzelbildern oder multimodalen Referenzen. Es unterstützt die Erstellung mit Anfangs- und Endbildvorgaben, referenzgestützte Bearbeitung sowie Bewegungs- oder Stimmbezüge. Die Clips sind 4–15 Sekunden lang; für die 2K-Neugenerierung gibt es einen gesonderten Ablauf.
Ü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.
Ein audiovisuelles Ergebnis aus einem multimodalen Briefing
MiniMax H3 ist das omnimodale Videosystem von MiniMax. Es interpretiert Text, Bilder, Video und Audio gemeinsam und erzeugt anschließend Video mit nativem Stereoton. Der Hersteller stellt es für kurze kreative Arbeiten wie Produktvisualisierungen, Werbung, animierte Poster und Filmtitelkonzepte vor, bei denen die Beziehungen zwischen Referenzmaterialien ebenso wichtig sind wie die Szenenbeschreibung.
Das dokumentierte System erzeugt 4–15 Sekunden lange Videos mit 24 Bildern pro Sekunde und 32-kHz-Stereo-Audio. Die Generierung mit H3-Base arbeitet bei 768p; der vollständige 2K-Ablauf generiert dieses Ergebnis unter Verwendung des ursprünglichen multimodalen Kontexts neu. Das geht über eine herkömmliche Größenänderung hinaus: Die zweite Stufe nutzt Modell und Quellkontext erneut, um feine Details wiederherzustellen. H3 Max und H3-Context-IR haben eigene Rollen und Grenzen.
Erstellung mit Text und Einzelbildvorgaben
Eine reine Texteingabe beschreibt den vollständigen audiovisuellen Zeitverlauf. Ein erstes Bild verankert den Anfang, ein letztes den Schluss; zwei Bilder können beides festlegen. Beginnen Sie bei einer Einstellung mit Startbild mit der in der Aufnahme sichtbaren Komposition und Identität und beschreiben Sie anschließend die daraus entstehende Handlung. Beschreiben Sie bei einem Übergang vom ersten zum letzten Bild die beobachtbare Bewegung zwischen den beiden Zuständen, statt zwei unverbundene Bildbeschreibungen zu wiederholen.
Ein praktisches Produktbriefing kann eine geschlossene Verpackung im Anfangsbild, die öffnende Hand, die sanfte Kamerabewegung und den zu erreichenden Endzustand festlegen. Bewahren Sie Objektform, Etikettenposition und Beleuchtung in den bereitgestellten Bildern. Bildgeführte und referenzgeführte Erstellung sind getrennte Eingabemodi. Die Herstellerschnittstelle kombiniert Anfangs-/Endbildrollen nicht mit Referenzmedienrollen in derselben Anfrage.
Referenzgeführte Generierung und Bearbeitung
Der Referenzmodus akzeptiert Text mit Bildern, Video- und Audioclips. Benennen Sie den Beitrag jeder Quelle: das Erscheinungsbild einer Figur, einen Ort, Kamerabewegung, die zeitliche Struktur eines Quellclips oder eine Stimme. Ein Video, das nur die Kamerabewegung vorgibt, ist etwas anderes als ein Video, das tatsächlich bearbeitet oder fortgesetzt werden soll. Machen Sie diese Beziehung ausdrücklich klar.
Der Referenzleitfaden des Herstellers trennt Motivdefinitionen, eine Aufgabenzusammenfassung, eine Analyse der zu bewahrenden Elemente, eine detaillierte Einstellungsbeschreibung, die gesamte Klanglandschaft und Hintergrundmusik, die nur das Publikum hört. Er unterscheidet die Bewahrung sichtbarer Inhalte von der Übertragung von Eigenschaften oder einer allgemeinen Stilreferenz. Bei Audio ist das Kopieren eines Signals etwas anderes als die Referenz auf Klangfarbe, Rhythmus oder Sprechweise. Halten Sie diese Rollen im gesamten Briefing konstant.
Stellen Sie für eine referenzgesteuerte Szene ein Figurenbild, eine kurze Referenz für die Kamerabewegung und eine Audioreferenz für die Stimme bereit und beschreiben Sie anschließend, wo sie jeweils die Zieleinstellung beeinflussen sollen. Geben Sie an, welche Kleidungs-, Umgebungs- oder Objektdetails erkennbar bleiben müssen. Vergleichen Sie den fertigen Clip mit diesen Anforderungen, einschließlich Bewegungskontinuität und Beziehung zwischen sichtbarer sprechender Person und hörbarer Stimme.
Sprache, Ton und Einstellungs-Timing
H3 modelliert Dialog, physische Geräusche, Atmosphäre und Musik gemeinsam. Die Modellkarte dokumentiert stabile Dialogunterstützung für Arabisch, Chinesisch, Englisch, Französisch, Deutsch, Italienisch, Japanisch, Koreanisch, Portugiesisch, Russisch und Spanisch; für andere Sprachen wird eine unterschiedliche Unterstützung beschrieben. Geben Sie genauen gesprochenen Wortlaut und Sprache an und halten Sie die Sprecheridentität über mehrere Einstellungen hinweg konstant.
Die Prompt-Leitfäden des Herstellers verwenden Englisch für beschreibende Abschnitte und bewahren Dialog und sichtbaren Text in ihrer ursprünglichen Sprache. Gesprochener Inhalt nutzt <d>[Language] ...</d>, während Sprecheridentität und Stimmbeschreibung außerhalb des Blocks stehen. Unterscheiden Sie physisch gesprochene Sprache von einem Off-Kommentar und benennen Sie, ob ein Satz über einen Schnitt hinweg weiterläuft oder vom Ende abgeschnitten wird. Bewahren Sie auch sichtbaren Text exakt. Passen Sie den Sprachumfang an die gewählte Dauer an und prüfen Sie gerenderte Wörter und hörbaren Satz gemeinsam.
Beschreiben Sie Kamerabewegung als Handlung, gegebenenfalls einschließlich Umfang und Geschwindigkeit. Nummerieren Sie Einstellungen in Wiedergabereihenfolge und halten Sie Schnittzeitpunkte innerhalb der Videodauer. Trennen Sie Szenengeräusche wie Schritte oder das Schließen einer Tür von Hintergrundmusik, die nur das Publikum hört. Diese Entscheidungen erleichtern es, einen kurzen Einstellungsplan zu interpretieren und anhand seines Ergebnisses zu prüfen.
Vorbereitung der Eingaben und numerische Grenzen
Das aktuelle Generierungsschema verlangt in jedem Modus nicht leeren Text mit bis zu 7.000 Zeichen pro Textelement. Bilder dürfen als JPG, JPEG, PNG, WebP, HEIC oder HEIF vorliegen, mit bis zu 30 MB pro Datei, Seitenlängen von 256 bis 5.760 Pixeln und einem Seitenverhältnis von 0,4 bis 2,5. Die Einzelbildeingabe erlaubt ein Anfangs- und ein Endbild; der Referenzmodus erlaubt bis zu neun Referenzbilder.
Referenzvideo kann bis zu drei MP4- oder MOV-Clips enthalten, jeweils 2–15 Sekunden und zusammen höchstens 15 Sekunden lang. Ein Clip darf bis zu 50 MB groß sein. Sein Videocodec ist H.264 oder H.265, mit AAC- oder MP3-Audio, Seitenlängen von 256 bis 5.760 Pixeln, Seitenverhältnissen von 0,4 bis 2,5 und Bildraten von 23,976 bis 60. Referenzaudio unterstützt bis zu drei WAV- oder MP3-Clips, jeweils bis zu 15 MB und 2–15 Sekunden, zusammen höchstens 15 Sekunden. Die Modellkarte begrenzt gemischte Referenzeingaben auf 12 Dateien. Die dokumentierte Grenze für den Anfragekörper beträgt 64 MB und ist von den Einzeldateigrenzen getrennt.
Wählen Sie nur Referenzen, die zum Briefing beitragen, und machen Sie jeden Beitrag ausdrücklich klar. Eine klare Motivansicht ist hilfreicher als mehrere widersprüchliche Ansichten ohne Erläuterung. Bewahren Sie die Referenzreihenfolge, schneiden Sie irrelevantes Material ohne Verlust nötigen Szenenkontexts weg und prüfen Sie, ob kurze Quellclips die gewünschte Handlung oder Stimmeigenschaft enthalten.
Ausgabeformat und vollständiges System
Die H3-Schnittstelle des Herstellers bietet 768P und 2K. Reine Textgenerierung verlangt ein konkretes Seitenverhältnis: 21:9, 16:9, 4:3, 1:1, 3:4 oder 9:16. Bei der Erstellung mit Anfangs-/Endbild wird das Seitenverhältnis vom Eingabebild übernommen; die referenzgestützte Erstellung kann ein adaptives oder ausdrückliches Verhältnis verwenden. Die ganzzahlige Ausgabedauer beträgt 4–15 Sekunden.
Die Modellkarte unterscheidet H3-Context-IR zur Interpretation und Anreicherung des Briefings, H3-Base zur Generierung audiovisueller Inhalte und H3-Regenerate-2K zur Erzeugung des höher aufgelösten Ergebnisses. Die veröffentlichten Basis-Checkpoints trennen bildgeführte Aufgaben von Omni-Reference-Aufgaben. Kontext- und Regenerierungskomponenten sind von diesen Basisgewichten getrennt. Der Name eines offenen Checkpoints allein belegt deshalb nicht das Verhalten des vollständigen Systems.
Der Generierungsablauf des Herstellers ist asynchron. Seine Schnittstelle zur Auftragsabfrage ruft Aufträge aus den vorangegangenen sieben Tagen ab. Behalten Sie die Auftragskennung, bis das tatsächliche Videoergebnis zurückgegeben wird, und speichern Sie anschließend den Clip, statt nur eine zeitlich begrenzte Download-Adresse aufzubewahren. Prüfen Sie visuelle Identität, kleine Schrift, Objektinteraktionen, gesprochenen Inhalt und Ton-Timing in der vorgesehenen Betrachtungsgröße. Der Hersteller nennt multimodales Verständnis und feine Bilddetails als Bereiche weiterer Verbesserung; ein detailliertes Briefing und der Vergleich mit den Quellen bleiben zentral für ein brauchbares Ergebnis.
Ailoot Ultra · Video POST /v1/videos minimax/hailuo-3
minimax/hailuo-3Start
MiniMax H3 erzeugt kurze Videos mit nativem Stereo-Audio aus Text, Einzelbildern oder multimodalen Referenzen. Es unterstützt die Erstellung mit Anfangs- und Endbildvorgaben, referenzgestützte Bearbeitung sowie Bewegungs- oder Stimmbezüge. Die Clips sind 4–15 Sekunden lang; für die 2K-Neugenerierung gibt es einen gesonderten Ablauf.
- Zulässige Eingaben
- Text · Bilder · Audio · Video
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabetypen
text,image,audio,video- Ausgabetypen
video- Ausgabeformat
- Originale MP4-Bytes; keine Normalisierung/Transkodierung
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits minimax/hailuo-3 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 2K | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungOptional | Werte und Limits false, true | Standard— |
Feldframe_images | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 2 Eingabeinhalt: Array von Frame-Objekten. Jedes Objekt enthält type=image_url, image_url mit url und frame_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame_type auf first_frame oder last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält ausschließlich url. Lassen Sie frame_images bei einer reinen Textanfrage weg. | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits | Standard— |
Feldcallback_url | Typstring | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtrace | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration
Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.
model: Typ: string · minimax/hailuo-3
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Bild zu Video · Ein schriftlicher Prompt und ein Bild für den ersten Frame. · Erforderlich: model, prompt, duration, frame_images
frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame und optional last_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Verwenden Sie in einer Anfrage entweder Frame-Bilder oder Bildreferenzen; kombinieren Sie nicht beides. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.
Exakte Schlüssel: type, image_url, frame_type
model: Typ: string · minimax/hailuo-3
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Reference to video · Ein schriftlicher Prompt und unterstützte Bild-, Video- und Audioreferenzen. · Erforderlich: model, prompt, duration, input_references
input_references ist ein Array von Objekten. Setzen Sie type auf image_url, video_url oder audio_url und verwenden Sie das dazu passende Feld mit url. Verwenden Sie öffentliche HTTPS-URLs. Lassen Sie frame_images weg, um den Referenzmodus auszuwählen. Die Schätzung berücksichtigt den angezeigten Anteil pro Bild ausschließlich für Bildreferenzen nach den ersten fünf. Die endgültige Abrechnung richtet sich nach der tatsächlich abgerechneten Konfiguration. Kombinieren Sie Bildreferenzen nicht mit Frame-Bildern. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.
model: Typ: string · minimax/hailuo-3
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration |
Parametermaterial_types | Vertragtext, image, audio, video |
Parameteradditional_properties | Vertragfalse |
Parameteroptional_controls | Vertragresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Abrechnungsbedingungen— | 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 |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.26 pro Videosekunde |
| KonfigurationReferenzbild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Referenzbild | Abrechnungsbedingungen— | Gebühr Eingabe · Referenzbild · Schätzung nur zum Vergleich $0.08 pro Referenzbild |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $1.3 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 →
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.
Preisreferenzen für Videokonfigurationen
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationVideopreis | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videopreis $0.26 pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationReferenzbilder nach den ersten fünf | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Eingabe · Referenzbilder nach den ersten fünf $0.08 pro Bild Die ersten fünf Referenzbilder sind kostenlos; der aufgeführte Preis pro Bild gilt nach den ersten fünf. Veröffentlichte Preisreferenz für die dargestellte Konfiguration. Die endgültige Abrechnung richtet sich nach der tatsächlich abgerechneten Konfiguration. |
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
Signierte Inhalts-URLs der Ihnen zugeordneten Assets
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Abrufe anderer Inhalte
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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 jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.
Wenn die ursprüngliche Antwort geprüft werden muss
503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldindex | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
Feldcontent_url | Typstring | BedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
Feldduration_ms | Typinteger | null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
Feldwidth | Typinteger | null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
Feldheight | Typinteger | null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
Feldvideo_codec | Typstring | null | BedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet. |
Feldhas_audio | Typboolean | null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort404 · not_found_error | BedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden. | Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel passt nicht zum authentifizierten Konto. | Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff. |
Antwort400 · invalid_request_error | BedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig. | Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat. |
Antwort422 · price_unavailable | BedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden. | Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra minimax/hailuo-3
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · MiniMax: H3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·minimax/hailuo-3:text,image,audio,video→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·minimax/hailuo-3:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Welche Grenzen gelten?
POST /v1/videos·minimax/hailuo-3:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1