ToAPIs
    StartseiteToAPIs
    BildgenerierungGPT Image 2.6, Gemini, FLUX…VideogenerierungSeedance, Veo, Kling, Sora…Chat & TextGPT-5.6, Claude, DeepSeek…Sprache & MusikVoiceover, TTS, Audio
    Neu erschienenSeedance 2.5
    PreiseAPI-DokumentationMCP
    BlogAlternativen
    AnmeldenKostenlos starten
    Alle ModellePreiseAPI-DokumentationMCPBlogAlternativen
    AnmeldenKostenlos starten

    Sprache

    Esc
    • Seedance 2.5Videogenerierung
    • GPT Image 2Bildgenerierung
    • GPT Image 2.6Bildgenerierung
    • GPT Image 2.5Bildgenerierung
    • Veo 3.1 FastVideogenerierung
    • Kling 3.0 TurboVideogenerierung
    • Kling V4 FlashVideogenerierung
    • Grok Video 1.5Videogenerierung
    • Nano Banana 2Bildgenerierung
    • Seedream 5.5Bildgenerierung
    • FLUXBildgenerierung
    • Sora 2Videogenerierung
    • Alle BildmodelleKategorie
    • Alle VideomodelleKategorie
    • GPT-5.6 SolChat & Codierung
    • Claude Opus 4.8Chat & Codierung
    • Claude Opus 4.7Chat & Codierung
    • DeepSeek V4 ProDeepSeek · Text
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Startseite
    2. Blog
    3. Tutorial
    4. MiniMax Hailuo 2.3 API-Integration: komplexe menschliche Bewegung in KI-Videos erzeugen
    Zurück zu allen Beiträgen
    tutorial2026-11-116 Min. Lesezeit

    MiniMax Hailuo 2.3 API-Integration: komplexe menschliche Bewegung in KI-Videos erzeugen

    Entwicklerleitfaden zur MiniMax Hailuo 2.3 Video-API auf ToAPIs: Prompt-Muster für menschliche Bewegung, der aktuelle Request-Vertrag für 6- und 10-Sekunden-Jobs in 768P und 1080P sowie cURL- und Python-Beispiele.

    ToAPIs Engineering & Evaluation Team
    MiniMax HailuoVideo APIHuman MotionImage-to-VideoTutorial
    TL;DR - Wichtigste Punkte
    • Verwenden Sie die Katalog-Modellzeichenkette MiniMax-Hailuo-2.3 für Text-zu-Video und First-Frame-Image-to-Video; MiniMax-Hailuo-2.3-Fast ist ausschließlich Image-to-Video.
    • Der aktuelle Vertrag erlaubt Dauern von 6 oder 10 Sekunden sowie Auflösungen 768P oder 1080P; 1080P unterstützt nur 6 Sekunden, und der Prompt ist auf 2.000 Zeichen begrenzt.
    • Dokumentierte Kameradirektiven wie [Push in] stehen im Prompt-Text und nicht in separaten API-Feldern. Hailuo 2.3 hat kein Feld für ein Endbild.
    • Speichern Sie die Task-ID, fragen Sie GET /v1/videos/generations/{id} ab und bestätigen Sie die aktuellen Kontopreise – verwenden Sie keine ungeprüfte Rate pro Sekunde erneut.

    MiniMax Hailuo 2.3 API-Integration: komplexe menschliche Bewegung in KI-Videos erzeugen

    Zielmodell: MiniMax-Hailuo-2.3
    Inferenz-Endpunkt: https://api.toapis.com/v1/videos/generations
    Verwandt: MiniMax H3 API-Leitfaden · Kamerabewegungs-Prompts für H3 · Automatisierte R2V-Pipeline


    1. Kurzüberblick und Leistungsübersicht

    • Aufgabe: Text-zu-Video- oder First-Frame-Image-to-Video-Jobs für Charakter- und Bewegungsclips an den Generierungs-Endpunkt von ToAPIs senden.
    • Vertrag: MiniMax-Hailuo-2.3 akzeptiert ganzzahlige Dauern von 6 oder 10 Sekunden und Auflösungen 768P oder 1080P. 1080P unterstützt nur 6 Sekunden. Die aktuelle API-Referenz begrenzt den Prompt auf 2.000 Zeichen.
    • IDs: Verwenden Sie die Katalogzeichenkette MiniMax-Hailuo-2.3 (Text-zu-Video und Image-to-Video). MiniMax-Hailuo-2.3-Fast ist nur Image-to-Video und verlangt eine Startbild-URL. Keine der beiden IDs ist mit minimax-h3 austauschbar.
    • Kamerasprache: Die ToAPIs Referenz zu Hailuo 2.3 dokumentiert Direktiven in eckigen Klammern wie [Push in] und [Pan left, Pedestal up]. Behandeln Sie die folgende Tabelle als aktuelles dokumentiertes Vokabular und prüfen Sie es anhand der Live-Dokumentation, bevor Sie eine Shot-Grammatik fest codieren.
    • Protokoll: REST mit Bearer. Speichern Sie die Task-id aus der Übergabeantwort und fragen Sie GET /v1/videos/generations/{task_id} (oder GET /v1/tasks/{task_id}) mit einer begrenzten Frist ab. Eine clientseitige Zeitüberschreitung beweist nicht, dass der Upstream-Task fehlgeschlagen ist.

    2. Prompt-Muster für menschliche Bewegung

    Der öffentliche ToAPIs Katalog beschreibt MiniMax Hailuo 2.3 als Videomodell für Charakterbewegung, Ausdruck und Stil in ausdrucksstarken Geschichten und Charakterclips. Das ist Produktpositionierung und kein unabhängiger Benchmark für „keine Gliedmaßen-Verzerrung“. Schreiben Sie für die Produktion Prompts, die ein Motiv und eine Hauptaktion in klarer mechanischer Sprache beschreiben, und prüfen Sie dann den Take.

    Ein brauchbarer Bewegungs-Prompt benennt die Körpermechanik, bevor Stil hinzukommt: wer sich bewegt, welches Glied führt, wie sich das Gewicht verlagert und wie die Aktion beginnt und endet. Halten Sie diesen Kern stabil, wenn Sie Dauer oder Auflösung im A/B-Test vergleichen; sonst kann eine geänderte Formulierung einen anderen Take erklären.

    Die ToAPIs Referenz zur Hailuo 2.3 API dokumentiert die folgenden Kameradirektiven. Sie stehen in der Prompt-Zeichenkette, nicht in einem separaten Request-Feld. Der Frontend-Request-Vertrag prüft prompt weiterhin als Text. Kombinieren Sie höchstens drei Direktiven in einer Klammer für gleichzeitige Bewegung oder ordnen Sie sie im Satz für aufeinanderfolgende Bewegungen.

    KategorieDokumentierte Direktiven
    Pan[Pan left], [Pan right]
    Tilt[Tilt up], [Tilt down]
    Push / Pull[Push in], [Pull out]
    Pedestal[Pedestal up], [Pedestal down]
    Truck[Truck left], [Truck right]
    Zoom[Zoom in], [Zoom out]
    Sonstiges[Shake], [Tracking shot], [Static shot]

    Abstrakter Posen-Graph des Startbilds beim Eintritt in das ToAPIs Gateway, der sich in Bewegungstakes aufteilt

    Abbildung 1: Behandeln Sie eine statische Pose als Eingabe für das Startbild, beschreiben Sie die folgende Aktion im Prompt und senden Sie eine einzelne Generierungsanfrage über das ToAPIs Gateway.

    Eine kompakte Vorlage, die testbar bleibt:

    text
    SUBJECT and PRIMARY ACTION (lead limb, weight shift, follow-through), ENVIRONMENT, [CAMERA], STYLE NOTES
    

    Beispiel: A contemporary dancer in a black practice leotard plants the left foot, then uncoils a slow 360-degree turn with the right arm leading and the torso stacked over the standing leg, warehouse skylight, [Tracking shot], photorealistic, no morphing limbs.

    Senden Sie für Image-to-Video eine öffentlich erreichbare Startbild-URL in image_urls. Das Bild ist der Startframe; der Prompt beschreibt die folgende Bewegung. Aktuell dokumentierte Bildlimits sind JPG, JPEG, PNG oder WebP; unter 20 MB; kurze Seite größer als 300 px; Seitenverhältnis zwischen 2:5 und 5:2. Setzen Sie kein Base64 in image_urls – laden Sie zuerst eine lokale Datei hoch.

    MiniMax-Hailuo-2.3-Fast akzeptiert kein Text-zu-Video: Eine Startbild-URL ist erforderlich. Hailuo 2.3 dokumentiert kein Feld für ein Endbild; die Start-zu-End-Interpolation gehört zu MiniMax-Hailuo-02, nicht zu dieser ID. Kopieren Sie keine H3-Felder wie ratio oder reference_videos in eine Hailuo 2.3 Anfrage.

    Optionslabels im Playground können 768p / 1080p in Kleinschreibung zeigen. Aktuelle API-Beispiele verwenden 768P und 1080P. Bestätigen Sie den Wert, den Ihr Konto akzeptiert, bevor Sie einen Batch automatisieren. Dieselbe Kameraformulierung lässt sich wiederverwenden, wenn Sie eine Einstellung zu MiniMax H3 verschieben, aber die Verträge für Dauer, Auflösung und Medienmodus sind anders – wechseln Sie die ID erst, nachdem Sie diesen Leitfaden erneut gelesen haben.


    3. Produktionsumsetzung: cURL und Python

    Schritt 1: Versand per cURL

    bash
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "MiniMax-Hailuo-2.3",
        "prompt": "A contemporary dancer in a black practice leotard plants the left foot, then uncoils a slow 360-degree turn with the right arm leading and the torso stacked over the standing leg, warehouse skylight, [Tracking shot], photorealistic, no morphing limbs",
        "duration": 6,
        "resolution": "768P"
      }'
    

    Schritt 2: Python-Hilfe und Poller

    Die offizielle Dokumentation nennt derzeit den öffentlichen Ursprung https://toapis.com (und https://toapis.cn für Festlandchina). Andere ToAPIs Guides dieser Reihe verwenden https://api.toapis.com. Wählen Sie eine Basis-URL und bleiben Sie konsistent. Der Ausschnitt folgt dem dokumentierten Task-Status-Pfad und den Zuständen completed / failed; bestätigen Sie id, result.data[0].url und die Antwortstruktur anhand der API-Referenz Ihres Kontos, bevor Sie ausliefern.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    ENDPOINT = f"{BASE}/v1/videos/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_motion_clip(
        prompt: str,
        duration: int = 6,
        resolution: str = "768P",
        image_url: str | None = None,
        model: str = "MiniMax-Hailuo-2.3",
    ) -> str:
        if resolution == "1080P" and duration != 6:
            raise ValueError("1080P currently supports a 6-second duration only")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "metadata": {"prompt_optimizer": True, "aigc_watermark": False},
        }
        if image_url:
            payload["image_urls"] = [image_url]
        elif model == "MiniMax-Hailuo-2.3-Fast":
            raise ValueError("MiniMax-Hailuo-2.3-Fast requires a first-frame image_urls value")
        res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_task(task_id: str, deadline_s: int = 300) -> str:
        poll_url = f"{BASE}/v1/videos/generations/{task_id}"
        interval = 5.0
        start = time.time()
        while time.time() - start < deadline_s:
            time.sleep(interval)
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            if poll.status_code == 429:
                retry_after = poll.headers.get("Retry-After")
                time.sleep(float(retry_after) if retry_after else min(interval * 2, 30))
                continue
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status == "completed":
                return data["result"]["data"][0]["url"]
            if status == "failed":
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            interval = min(interval * 1.5, 10.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    if __name__ == "__main__":
        prompt = (
            "A contemporary dancer in a black practice leotard plants the left foot, "
            "then uncoils a slow 360-degree turn with the right arm leading and the "
            "torso stacked over the standing leg, warehouse skylight, [Tracking shot], "
            "photorealistic, no morphing limbs"
        )
        task_id = dispatch_motion_clip(prompt)
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Speichern Sie die Version der Prompt-Vorlage beim Task-Datensatz, damit Sie einen Modellwechsel von einer Formulierungsänderung unterscheiden können. Wenn Sie einen Job mit Startbild benötigen, übergeben Sie image_url= an dispatch_motion_clip. Für die Fast-SKU ist dieses Argument erforderlich.

    Die Dauer von Hailuo 2.3 Basis ist 6 oder 10 Sekunden. Senden Sie 1080P nicht mit duration: 10. Wenn Sie durchgehende Clips von 4–15 Sekunden, Referenzmaterial oder Eingaben für ein Endbild benötigen, ist das ein anderer Vertrag – siehe den H3 API-Leitfaden und das R2V-Pipeline-Tutorial.


    4. Fehlerbehandlung und Statusmatrix

    Die folgenden Kategorien sind Ausgangspunkte für die Diagnose und keine Garantie für exakte ToAPIs Fehlercodes. Eine erfolgreiche HTTP-Abfrage erfordert weiterhin, den Task-status zu lesen.

    HTTP-StatusHäufige KategorieEmpfohlene Maßnahme
    400Ungültiges Feld, nicht unterstützte Kombination oder Konflikt im MedienmodusPrüfen Sie die genaue Modell-ID, ob die Dauer 6 oder 10 ist, ob 1080P nur mit 6 Sekunden kombiniert wird und ob Fast-Jobs image_urls enthalten. Senden Sie bei Hailuo 2.3 kein Feld für ein Endbild
    401Fehlender oder ungültiger API-SchlüsselRotieren Sie den Schlüssel im ToAPIs Dashboard und prüfen Sie den Authorization-Header
    429Rate- oder ParallelitätslimitBeachten Sie Retry-After, wenn vorhanden; weichen Sie mit Jitter zurück; wiederholen Sie nur, wenn es sicher ist
    5xx oder Netzwerk-ZeitüberschreitungVorübergehendes Gateway- oder Upstream-ProblemPrüfen Sie den Task-Status vor dem erneuten Senden und nutzen Sie eine begrenzte Wiederholungsstrategie

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. Preise und FinOps-ROI

    Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution\text{Estimated cost} = \text{successful billable jobs} \times \text{current account rate for that model, duration, and resolution}Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution

    • Verwenden Sie keine Stückpreise aus Planungsentwürfen. Preise pro Sekunde oder pro Video, Abrechnungseinheiten und der Umgang mit fehlgeschlagenen Tasks variieren je nach Modell, Auflösung, Dauer, Route und Konto. Offizielle Anbieter-Referenzzeilen auf der ToAPIs Preisseite dienen nur der Anzeige und können von der Abrechnung Ihres Kontos abweichen. Lesen Sie den aktuellen Katalog und das Angebot Ihres Kontos, bevor Sie eine Shot-Liste kalkulieren.
    • Fast ist eine andere SKU, kein kostenloser Geschwindigkeitsschalter auf derselben ID. MiniMax-Hailuo-2.3-Fast ist dokumentiert als ausschließlich Image-to-Video. Bestätigen Sie den aktuellen Kontopreis separat.
    • Steuern Sie die Kosten in der Prompt-Ebene: Entwerfen Sie in 768P und 6 Sekunden, halten Sie eine versionierte Vorlage, ändern Sie jeweils nur eine Variable und senden Sie nach einer clientseitigen Zeitüberschreitung erst erneut, wenn Sie den Task-Status geprüft haben.
    • Offizielle Anbieterverträge enthalten oft Jahresverpflichtungen, Sitzkontingente und Vorauszahlungsuntergrenzen. Die ToAPIs Abrechnung erfolgt typischerweise als Bezahlung nach Verbrauch – bestätigen Sie die aktiven Bedingungen Ihres Kontos.

    6. Häufig gestellte Fragen

    Siehe den FAQ-Block im Frontmatter. Kurzfassung: Die Request-Modellzeichenkette ist MiniMax-Hailuo-2.3, kein mit Bindestrichen versehener Slug und keine H3-ID; 1080P ist auf 6 Sekunden begrenzt; Fast erfordert eine Startbild-URL und unterstützt kein Text-zu-Video; dokumentierte Kameradirektiven stehen im Prompt und nicht in separaten Feldern; Hailuo 2.3 hat keine Eingabe für ein Endbild.


    7. Aktionscheckliste

    • Erstellen Sie einen Schlüssel im ToAPIs Developer Portal.
    • Testen Sie den cURL-Ausschnitt kurz mit MiniMax-Hailuo-2.3, resolution: "768P" und einer Dauer von 6 Sekunden.
    • Bestätigen Sie, ob Ihr Konto 768P oder 768p erwartet, und fragen Sie GET /v1/videos/generations/{id} mit einer begrenzten Frist ab.
    • Nächster Schritt: der H3-Leitfaden zu Kamerabewegungen, wenn Sie eine andere Dauer oder einen anderen Medienvertrag benötigen, und der Hailuo 2.3 Modell-Leitfaden für den Live-Status im Katalog.

    In diesem Beitrag erwähnte Modelle entdecken

    MiniMaxVIDEO

    minimax-hailuo-2.3

    Aktueller Preis: 38.8 credits /request
    Modell-LeitfadenIn der Konsole testenAPI-Schlüssel erhalten
    MiniMaxVIDEO

    minimax-hailuo-2.3-fast

    Aktueller Preis: 27.2 credits /request
    Modell-LeitfadenIn der Konsole testenAPI-Schlüssel erhalten
    MiniMaxVIDEO

    minimax-h3

    Aktueller Preis: 20.8 credits /second
    Modell-LeitfadenIn der Konsole testenAPI-Schlüssel erhalten

    Verwandte Artikel

    tutorial2026-11-10T10:00:00+08:005 Min. Lesezeit

    Der MiniMax H3 Prompt-Leitfaden: filmische Kamerabewegungen per API formulieren

    Entwicklerleitfaden für filmische Kamerabewegungs-Prompts in der MiniMax H3 Video-API auf ToAPIs: wiederverwendbare Vorlagen, cURL- und Python-Beispiele und der aktuelle Request-Vertrag des Frontends.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax H3
    tutorial2026-11-09T14:00:00+08:003 Min. Lesezeit

    Seedance 2.0 Mini API im Test: Videogenerierung mit hohem Durchsatz und kleinem Budget

    Entwickler-Benchmark zu ByteDance Seedance 2.0 Mini: Latenz unter 18 s, natives 720p bei 24fps und $0.012 pro Sekunde für hochparallelle Social- und Werbe-Pipelines.

    TO
    ToAPIs Engineering & Evaluation Team
    #Seedance 2.0 Mini
    tutorial2026-11-06T12:00:00+08:002 Min. Lesezeit

    4K-KI-Videos mit Seedance 2.0 erzeugen: Best Practices für Prompts und Parameter

    Meistern Sie die 4K-Ultra-HD-Videogenerierung mit der ByteDance Seedance 2.0 API. Lernen Sie Parameterkonfigurationen, Seitenverhältnis-Skalierung, Prompt-Optimierung und Timeout-Behandlung.

    TO
    ToAPIs Engineering & Evaluation Team
    #Seedance 2.0
    ToAPIs
    StartseiteToAPIs
    Unternehmens-KI-API-Gateway. Greife über eine einheitliche API auf GPT-5, Claude, Gemini und über 200 Modelle zu.

    Beliebte Modelle

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mehr anzeigenWeniger anzeigen
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Alle Modelle

    API-Kategorien

    • KI-Bild-API
    • KI-Video-API
    • Text-zu-Video-API
    • Bild-zu-Video-API
    Mehr anzeigenWeniger anzeigen
    • KI-Bildbearbeitungs-API
    • LLM- und Reasoning-API
    • Alle API-Tools →

    Alternativen

    Alternativen
    • Kie.ai-Alternative
    • Fal.ai-Alternative
    • OpenRouter-Alternative
    • Replicate-Alternative
    • Wavespeed-AI-Alternative
    • Alle Vergleiche →

    Empfohlene Leitfäden

    Empfohlene Leitfäden
    • Preise von Seedance 2.0 und 2.5
    • Leitfaden zur günstigsten Seedance-API
    • Integrationsleitfaden zu MiniMax H3
    • Kostenloser Seedance-2-API-Schlüssel
    • Schnellstart der Seedance-2-API
    • Alle Engineering-Beiträge →

    Entwickler und Plattform

    Entwickler und Plattform
    • API-Dokumentation
    • MCP
    • Preise
    • Modell-Playground
    • LLMs.txt
    • Support kontaktieren
    • Verzeichnis der Modell-Leitfäden
    Betreiber:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Sitz der Gesellschaft:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    DatenschutzNutzungsbedingungenZulässige NutzungDatenlöschungDatenaufbewahrungAuftragsverarbeiter und RegionenAbrechnung und ErstattungenCookie-RichtlinieSitemapÜber uns

    © 2026 ToAPIs. Alle Rechte vorbehalten.