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. Der MiniMax H3 Prompt-Leitfaden: filmische Kamerabewegungen per API formulieren
    Zurück zu allen Beiträgen
    tutorial2026-11-105 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.

    ToAPIs Engineering & Evaluation Team
    MiniMax H3Prompting GuideCamera MovementsVideo APITutorial
    TL;DR - Wichtigste Punkte
    • Schreiben Sie eine Szene, eine Hauptaktion und ergänzen Sie dann Kameraanweisung, Objektiv und Licht als normalen Prompt-Text.
    • Tags in eckigen Klammern wie [Pan Left] oder [Dolly In] sind nützliche Prompt-Hilfen; der Frontend-Vertrag von ToAPIs definiert sie nicht als native H3-Befehle.
    • Das Basis-Modell MiniMax H3 akzeptiert ganzzahlige Dauern von 4–15 Sekunden auf POST /v1/videos/generations; verwenden Sie das Feld ratio, nicht aspect_ratio.
    • Bestätigen Sie exakte Modell-ID, aktuelle Kontopreise und Antwortschema, bevor Sie eine Shot-Liste automatisieren.

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

    Zielmodell: minimax-h3
    Inferenz-Endpunkt: https://api.toapis.com/v1/videos/generations
    Verwandt: MiniMax H3 API-Leitfaden · Auswahl zwischen H3 und Turbo · Automatisierte R2V-Pipeline


    1. Kurzüberblick und Leistungsübersicht

    • Aufgabe: Eine Shot-Liste in wiederholbare MiniMax H3 Prompts übersetzen – Motiv, Aktion, Kamerapfad, Objektiv und Licht – und diese am Generierungs-Endpunkt von ToAPIs senden.
    • Prompt-Handwerk: Beginnen Sie mit der Kameraabsicht, dann folgt das Motiv. Kombinieren Sie eine Richtungsangabe mit einer Brennweite (zum Beispiel 35 mm gegenüber 85 mm) und einem Licht-Hinweis.
    • Vertrag: Das Basis-Modell minimax-h3 akzeptiert ganzzahlige Clips von 4–15 s. Verwenden Sie ratio (16:9, 9:16 und die weiteren unten gelisteten Seitenverhältnisse). Das ist der Request-Vertrag des Frontends, kein Latenz- oder Qualitätsbenchmark.
    • Vorsicht bei der Syntax: Tags in eckigen Klammern sind Prompt-Hilfen. Behandeln Sie [Pan Left] nicht als dokumentierten nativen Befehl, solange die Upstream-Modell Dokumentation das nicht sagt.
    • Protokoll: REST mit Bearer. Einmal senden, Task-Kennung speichern und den dokumentierten Task-Status-Endpunkt mit begrenzter Frist abfragen.

    2. Prompt-Muster für Kamerabewegungen

    Ein nützlicher H3-Prompt beschreibt eine Szene und eine Hauptaktion, bevor Kameraanweisung, Objektiv oder Stil hinzukommen. Halten Sie diese Bausteine stabil, wenn Sie ein Modell oder eine Dauer im A/B-Test vergleichen; sonst kann eine geänderte Formulierung einen anderen Take erklären.

    Die Tags in der folgenden Tabelle sind Prompt-Hilfen, keine garantierte Befehlsgrammatik. Der Frontend-Vertrag von ToAPIs prüft den Prompt als Text (bis zu 7.000 Unicode-Zeichen). Er belegt nicht, dass Zeichenketten wie [Pan Left] native H3-Befehle sind. Nutzen Sie sie als konsistentes Vokabular in Ihren Vorlagen und prüfen Sie anschließend die Ausgabe.

    Prompt-HilfeVisuelle BahnTypischer Einsatz
    [Pan Left] / [Pan Right]Horizontale Drehung um eine feste AchseLandschaftsaufdeckungen, Skyline-Schwenks
    [Tilt Up] / [Tilt Down]Vertikale Neigung von einer festen PositionTürme, hohe Motive, Himmelsaufdeckungen
    [Dolly In] / [Dolly Out]Kamera bewegt sich auf das Motiv zu oder davon wegEmotionale Betonung verdichten
    [Truck Left] / [Truck Right]Laterale MitlaufbewegungNeben einem Fahrzeug oder einer gehenden Person herfahren
    [Crane Shot] / [Pedestal Up]Vertikale Erhöhung der KameraEstablishing-Shots aus hohem Winkel
    [Orbit 180] / [Arc Shot]Halbkreisförmige Bewegung um das MotivProduktdrehungen, Helden-Enthüllungen
    [Hitchcock Zoom]Dolly In bei gleichzeitigem Zoom Out (oder umgekehrt)Psychologischer Schock, plötzliche Erkenntnis

    Abstrakte Kamerabahnen um einen Motivknoten

    Abbildung 1: Betrachten Sie Pan, Tilt, Dolly und Orbit als Bahnen im Prompt-Raum um ein Motiv und senden Sie dann eine einzelne Generierungsanfrage über das ToAPIs Gateway.

    Eine kompakte Vorlage, die testbar bleibt:

    text
    [CAMERA] SUBJECT and ACTION, LIGHTING, shot on LENS, STYLE NOTES
    

    Beispiel: [Orbit 180 + Slow Dolly In] Matte black mechanical wristwatch resting on volcanic stone, moody low-key rim lighting, subtle steam haze, shot on 85mm macro lens, photorealistic, cinematic motion blur.

    Bei Jobs mit Startbild (R2V) beschreibt dieselbe Prompt-Sprache, wie sich die Kamera um das Ankerbild herum oder davon weg bewegen soll. Die Request-Felder stehen im R2V-Pipeline-Tutorial. Frame-Eingaben und Referenzmaterial bleiben sich gegenseitig ausschließende Modi.

    Unterstützte ratio-Werte im aktuellen Frontend sind adaptive, 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Frame-Eingaben erzwingen adaptive. Senden Sie nicht aspect_ratio; das Vertragsfeld heißt ratio.


    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-h3",
        "prompt": "[Orbit 180 + Slow Dolly In] Matte black mechanical wristwatch resting on volcanic stone, moody low-key rim lighting, subtle steam haze, shot on 85mm macro lens, photorealistic, cinematic motion blur",
        "duration": 6,
        "ratio": "16:9"
      }'
    

    Schritt 2: Prompt-Hilfe und Polling in Python

    Passen Sie Feldnamen und Antwortstruktur an die API-Referenz Ihres Kontos an. Der Ausschnitt nutzt den Task-Status-Pfad, der auch in anderen ToAPIs Video-Guides erscheint; bestätigen Sie task_id, status und video_url gegen dieses Schema, bevor Sie ausliefern.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    ENDPOINT = "https://api.toapis.com/v1/videos/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def build_cinematic_prompt(
        subject: str,
        camera_move: str,
        lighting: str,
        lens: str = "35mm anamorphic",
    ) -> str:
        return (
            f"[{camera_move}] {subject}, {lighting}, "
            f"shot on {lens}, photorealistic, cinematic motion blur."
        )
    
    
    def dispatch_camera_shot(prompt: str, duration: int = 6, ratio: str = "16:9") -> str:
        payload = {
            "model": "minimax-h3",
            "prompt": prompt,
            "duration": duration,
            "ratio": ratio,
        }
        res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
        res.raise_for_status()
        data = res.json()
        task_id = data.get("task_id") or data.get("id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_task(task_id: str, deadline_s: int = 180) -> str:
        poll_url = f"https://api.toapis.com/v1/videos/tasks/{task_id}"
        interval = 3.0
        start = time.time()
        while time.time() - start < deadline_s:
            time.sleep(interval)
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status in {"succeeded", "success"}:
                return data["video_url"]
            if status in {"failed", "error"}:
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            interval = min(interval * 1.5, 8.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    if __name__ == "__main__":
        prompt = build_cinematic_prompt(
            subject="Matte black mechanical wristwatch resting on volcanic stone",
            camera_move="Orbit 180 + Slow Dolly In",
            lighting="Moody low-key rim lighting, subtle steam haze",
            lens="85mm macro lens",
        )
        task_id = dispatch_camera_shot(prompt)
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Speichern Sie die Version der Prompt-Vorlage neben dem Task-Datensatz, damit Sie einen Modellwechsel von einer Formulierungsänderung unterscheiden können. Eine clientseitige Zeitüberschreitung beweist nicht, dass der Upstream-Task fehlgeschlagen ist – prüfen Sie den Status, bevor Sie einen zweiten kostenpflichtigen Job senden.

    Die Dauer des Basis-H3 ist eine Ganzzahl von 4 bis 15 Sekunden. IDs der Max-Familie beginnen bei 5 Sekunden und haben eigene Auflösungslisten; Turbo akzeptiert kein Referenzmaterial. Prüfen Sie den API-Leitfaden, bevor Sie die ID wechseln.


    4. Fehlerbehandlung und Statusmatrix

    Die folgenden Kategorien sind Ausgangspunkte für die Diagnose und keine Garantie für exakte ToAPIs Fehlercodes.

    HTTP-StatusHäufige KategorieEmpfohlene Maßnahme
    400Ungültiges Feld, nicht unterstützter Wert oder Konflikt im MedienmodusPrüfen Sie Modell-ID, Dauer, ratio, Auflösung und ob Frame-Eingaben mit Referenzmaterial gemischt sind
    401Fehlender oder ungültiger API-SchlüsselRotieren Sie den Schlüssel im ToAPIs Dashboard und prüfen Sie den Authorization-Header
    429Rate- oder ParallelitätslimitWeichen 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 output seconds×current account rate per second\text{Estimated cost} = \text{successful output seconds} \times \text{current account rate per second}Estimated cost=successful output seconds×current account rate per second

    • Verwenden Sie keine Stückpreise aus Planungsentwürfen. Preise pro Sekunde, Abrechnungseinheiten und der Umgang mit fehlgeschlagenen Tasks variieren je nach Modell, Route und Konto. Lesen Sie den aktuellen ToAPIs Katalog und das Angebot Ihres Kontos, bevor Sie eine Shot-Liste kalkulieren.
    • Offizielle Anbieterverträge enthalten oft Jahresverpflichtungen, Kontingente pro Nutzer und Vorauszahlungsuntergrenzen. Die ToAPIs Abrechnung erfolgt typischerweise als Bezahlung nach Verbrauch – bestätigen Sie die aktiven Bedingungen Ihres Kontos.
    • Steuern Sie die Kosten in der Prompt-Ebene: versionierte Vorlage, jeweils nur eine Variable ändern und nach einer clientseitigen Zeitüberschreitung erst den Task-Status prüfen, bevor Sie erneut senden.
    • Für den Abwägung zwischen Varianten (Basis-H3, kanonisches Max, Turbo) nutzen Sie den Auswahl-Leitfaden statt eines nicht verifizierten Geschwindigkeits- oder Qualitätswerts.

    6. Häufig gestellte Fragen

    Siehe den FAQ-Block im Frontmatter. Kurzfassung: Kameraabsicht an den Prompt-Anfang; zusammengesetzte Kameraformulierungen sind Prompt-Text und keine garantierte Grammatik; dieselbe Formulierung gilt im Startbild-Modus; Tags in eckigen Klammern sind keine offiziellen API-Parameter.


    7. Aktionscheckliste

    • Erstellen Sie einen Schlüssel im ToAPIs Developer Portal.
    • Testen Sie den cURL-Ausschnitt kurz mit minimax-h3, ratio: "16:9" und einer Dauer von 6 Sekunden.
    • Übernehmen Sie die Prompt-Hilfe, speichern Sie Vorlagenversionen und fragen Sie mit einer Frist von 180 s ab.
    • Nächster Schritt: der Request-Vertrag der H3 API und die automatisierte R2V-Pipeline.

    In diesem Beitrag erwähnte Modelle entdecken

    MiniMaxVIDEO

    minimax-h3

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

    minimax-h3-max

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

    minimax-h3-max-turbo

    Aktueller Preis: Live-Preise ansehen
    Modell-LeitfadenIn der Konsole testenAPI-Schlüssel erhalten

    Verwandte Artikel

    tutorial2026-11-11T10:00:00+08:006 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.

    TO
    ToAPIs Engineering & Evaluation Team
    #MiniMax Hailuo
    tutorial2026-11-10T14:00:00+08:005 Min. Lesezeit

    Eine automatisierte Image-to-Video-Pipeline (R2V) mit der MiniMax H3 API aufbauen

    Engineering-Tutorial für eine automatisierte Reference-to-Video-Pipeline auf MiniMax H3: Eingaben für das Startbild, Asset-Bereitstellung, begrenztes Task-Polling und der Request-Vertrag des ToAPIs 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
    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.