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. Praxis mit der Grok-Video-3 API: alles Wichtige zur Video-Engine von xAI
    Zurück zu allen Beiträgen
    tutorial2026-11-176 Min. Lesezeit

    Praxis mit der Grok-Video-3 API: alles Wichtige zur Video-Engine von xAI

    Praxisleitfaden für xAI Grok Video auf ToAPIs: Der öffentliche Katalog listet weiterhin grok-video-1.0 und grok-video-1.5 und nicht grok-video-3, mit aktuellem Generierungsvertrag, Modi und Polling-Pfad.

    ToAPIs Engineering & Evaluation Team
    Grok VideoVideo APIxAIText-to-VideoTutorial
    TL;DR - Wichtigste Punkte
    • Nach der öffentlichen Katalog-Momentaufnahme vom 2026-11-10 und einer Prüfung der Docs- und Modell-Leitfaden-Seiten am 2026-11-17 gibt es keine öffentliche ToAPIs Modell-ID namens grok-video-3. Die dokumentierten Grok Video IDs sind grok-video-1.0 und grok-video-1.5.
    • Senden Sie Jobs an POST /v1/videos/generations mit einem Bearer-API-Key. Speichern Sie die Task-ID und fragen Sie GET /v1/videos/generations/{id} ab. Rufen Sie keinen undokumentierten /videos/tasks Pfad auf.
    • grok-video-1.5 dokumentiert drei explizite Modi: text_to_video, first_frame_image_to_video und reference_images_to_video. Setzen Sie video_generation_mode passend zu den tatsächlich gesendeten Medien.
    • Bilder müssen öffentliche http(s)-URLs sein. Laden Sie lokale Dateien zuerst mit POST /v1/uploads/images hoch; base64 wird von diesen Generierungs-APIs nicht akzeptiert.
    • Verwenden Sie keine ungeprüften Preise pro Sekunde oder SLA-Werte aus Planungsentwürfen erneut. Bestätigen Sie Live-Tarif und Kanalunterstützung in Ihrem Konto, bevor Sie eine Shot-Liste kalkulieren.

    Praxis mit der Grok-Video-3 API: alles Wichtige zur Video-Engine von xAI

    Zielmodelle: grok-video-1.5, grok-video-1.0
    Inferenz-Endpunkt: https://api.toapis.com/v1/videos/generations
    Verwandt: OpenAI-kompatibler Zugang · API des offiziellen Grok Imagine Kanals · Hailuo 2.3 Video-Leitfaden · Grok Video 1.5 Referenz


    1. Kurzüberblick und Leistungsübersicht

    • Katalog zuerst: Auch Anfragen für eine praktische Grok Video 3 Integration müssen mit den IDs beginnen, die ToAPIs tatsächlich veröffentlicht. Die öffentliche Produktions-Katalog-Momentaufnahme vom 2026-11-10 listet grok-video-1.0 und grok-video-1.5 am openai-video Endpunkt. Eine Prüfung der grok-video-3 Dokumentations- und Modell-Leitfaden-URLs am 2026-11-17 ergab HTTP 404.
    • Vertrag: Senden Sie asynchron an POST /v1/videos/generations und fragen Sie dann GET /v1/videos/generations/{id} ab, bis completed oder failed erreicht ist. Offizielle Beispiele verwenden https://toapis.com (und https://toapis.cn für Festlandchina). Andere Guides dieser Reihe verwenden https://api.toapis.com. Wählen Sie einen Ursprung und bleiben Sie konsistent.
    • Modi: grok-video-1.5 dokumentiert text_to_video, first_frame_image_to_video und reference_images_to_video. Setzen Sie video_generation_mode explizit, damit ein einzelnes Referenzbild nicht als Legacy-Startbild-Job behandelt wird.
    • Medien: Senden Sie nur öffentliche http:// oder https:// URLs. Laden Sie lokale Dateien mit POST /v1/uploads/images hoch und nutzen Sie die zurückgegebene data.url. Senden Sie kein base64.
    • Nicht verifizierte Aussagen streichen: Planungsentwürfe, die eine grok-video-3 ID, ein SLA von 99,95 %, einen festen Satz von $0.030–$0.038 pro Sekunde oder ein künftiges Audio-Release-Datum nennen, sind keine aktuelle ToAPIs Dokumentation. Bestätigen Sie Live-Tarife und Kanalunterstützung in Ihrem Konto.

    2. Aktuelle Grok Video IDs und Generierungsmodi

    Verwenden Sie den öffentlichen Modellnamen im Feld model. Ersetzen Sie ihn nicht durch einen anbieternativen Namen, einen URL-Slug oder eine unveröffentlichte grok-video-3 Zeichenkette.

    Katalog-IDDokumentierte JobsDauer (Docs)AuflösungBildeingaben
    grok-video-1.5Text, Startbild oder 1–7 Referenzbilder, ausgewählt über video_generation_modeGanzzahl 1–15 Sekunden480p oder 720p im Referenzmodus; Text und Startbild können 1080p nutzen, wenn der Kanal das unterstütztStartbild: genau ein image oder input_reference. Referenzmodus: 1–7 reference_images
    grok-video-1.0Text-zu-Video und Bild-zu-VideoGenerierungsreferenz: 1–15 Sekunden (Standard 8). Modell-Leitfaden / Playground: eine 6-Sekunden-Grenze bei der aktuell verfügbaren Variante480p, 720pOptionales image plus reference_images; bis zu 8 Bilder insgesamt

    Für grok-video-1.5 sollten neue Integrationen den Modus explizit setzen:

    video_generation_modeErforderliche EingabeMuss weggelassen werden
    text_to_videoNicht leerer promptJedes Bildfeld
    first_frame_image_to_videoGenau ein Startbild in image oder input_referenceWidersprüchliche Werte in beiden Aliasen; senden Sie außerdem keine Referenzliste, sofern die Referenz Ihres Kontos nichts anderes sagt
    reference_images_to_videoprompt plus 1–7 reference_images (Strings oder {"url":"..."}-Objekte)Sich auf einen einzelnen reference_images-Eintrag ohne diesen Modus verlassen – die Legacy-Eingabe mit einem Bild bleibt Startbild-Verhalten

    Ein erfolgreiches Preisangebot garantiert nicht, dass ein Generierungskanal offen ist. Modi sind nur verfügbar, wenn sie auf einem kompatiblen Kanal freigeschaltet sind; nicht unterstützte Kombinationen können abgelehnt werden, bevor ein Task entsteht.

    Übliche Seitenverhältniswerte in den Grok Video Referenzen sind 16:9, 9:16, 3:2, 2:3 und 1:1. Die Verfügbarkeit hängt weiter vom Kanal ab, senden Sie also einen Wert, den Sie für diese ID bestätigt haben.

    Leere Eingabeframes, die durch ein hexagonales Gateway in einen Ausgabeframe laufen

    Abbildung 1: Senden Sie einen Prompt (und optionale öffentliche Bild-URLs) an POST /v1/videos/generations, fragen Sie dieselbe Task-ID ab und lesen Sie result.data[0].url erst, wenn der Status completed ist.

    Wenn Sie Funktionen des offiziellen Grok Imagine Kanals wie Videoverlängerung benötigen, ist das eine andere ID-Familie – siehe den Leitfaden zum offiziellen Imagine-Kanal. Für einen zweiten Videovertrag mit anderer Dauer-Matrix siehe den Hailuo 2.3 Leitfaden.


    3. Produktionsumsetzung: cURL und Python

    Die internationalen Beispiele dieser Reihe verwenden https://api.toapis.com. Die offizielle Dokumentation verweist Nutzer in Festlandchina auf https://toapis.cn. Behalten Sie einen Ursprung pro Umgebung. Pfade, Modell-IDs und der Bearer-Header bleiben gleich.

    Schritt 1: cURL-Versand für grok-video-1.5

    bash
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "grok-video-1.5",
        "prompt": "A cinematic product shot with a slow camera push-in",
        "video_generation_mode": "text_to_video",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      }'
    

    Ein Startbild-Job nutzt denselben Pfad mit "video_generation_mode": "first_frame_image_to_video" und einer URL in image. Ein Referenzbild-Job setzt "video_generation_mode": "reference_images_to_video" und eine reference_images Liste und hält resolution bei 480p oder 720p.

    Schritt 2: Python-Hilfe und Poller

    Der Ausschnitt folgt dem dokumentierten Task-Status-Pfad und den Zuständen queued / in_progress / 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_grok_video(
        prompt: str,
        *,
        model: str = "grok-video-1.5",
        mode: str = "text_to_video",
        duration: int = 8,
        resolution: str = "720p",
        aspect_ratio: str = "16:9",
        image_url: str | None = None,
        reference_images: list[str] | None = None,
    ) -> str:
        if model == "grok-video-3":
            raise ValueError("grok-video-3 is not a current public catalog ID")
        if mode == "reference_images_to_video" and resolution not in {"480p", "720p"}:
            raise ValueError("reference mode is documented as 480p or 720p")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "aspect_ratio": aspect_ratio,
        }
        if model == "grok-video-1.5":
            payload["video_generation_mode"] = mode
        if mode == "text_to_video" and (image_url or reference_images):
            raise ValueError("text_to_video rejects image fields")
        if mode == "first_frame_image_to_video":
            if not image_url:
                raise ValueError("first-frame mode requires exactly one image URL")
            payload["image"] = image_url
        if mode == "reference_images_to_video":
            refs = reference_images or []
            if not (1 <= len(refs) <= 7):
                raise ValueError("reference mode requires 1-7 image URLs")
            payload["reference_images"] = refs
        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 = 600) -> str:
        poll_url = f"{BASE}/v1/videos/generations/{task_id}"
        interval = 10.0
        start = time.time()
        time.sleep(5)
        while time.time() - start < deadline_s:
            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, 120))
                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')}")
            time.sleep(interval)
            interval = min(interval * 1.5, 30.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    if __name__ == "__main__":
        task_id = dispatch_grok_video(
            "A cinematic product shot with a slow camera push-in",
            mode="text_to_video",
            duration=8,
            resolution="720p",
        )
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Speichern Sie die Version der Prompt-Vorlage beim Task-Datensatz, damit Sie einen Modell- oder Moduswechsel von einer Formulierungsänderung unterscheiden können. Laden Sie die Datei vor expires_at herunter; die Statusreferenz dokumentiert ein 30-Tage-Aufbewahrungsfenster.


    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. Siehe die Fehlerreferenz für Request-Fehler gegenüber status: failed Gründen wie content_policy_rejected, insufficient_user_balance oder generation_timeout.

    HTTP- oder Task-ZustandHäufige KategorieEmpfohlene Maßnahme
    400Ungültiges Feld, Modus-/Medien-Mismatch oder nicht unterstützte KombinationPrüfen Sie die exakte Katalog-ID, ob video_generation_mode zu den Bildfeldern passt, ob der Referenzmodus bei 480p oder 720p bleibt und ob Bildwerte öffentliche URLs sind
    401Fehlender oder ungültiger API-SchlüsselRotieren Sie den Schlüssel im ToAPIs Dashboard und bestätigen Sie den Authorization: Bearer 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 clientseitige ZeitüberschreitungVorübergehendes Gateway- oder Upstream-ProblemFragen Sie die bestehende Task-ID ab, bevor Sie erneut senden
    status: queued oder in_progressKein FehlerWarten und erneut abfragen; keinen zweiten Job anlegen
    status: failedGenerierung nicht erfolgreichLesen Sie error.code und error.message (und error.reason, falls vorhanden). Wiederholen Sie keinen unveränderten, durch Policy abgelehnten Payload

    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 erneut. Die API-Referenz von grok-video-1.5 stellt fest, dass die Preisgestaltung der aktuellen Konto- und SKU-Konfiguration folgt und die Seite keinen festen Preis pro Sekunde garantiert. Offizielle Anbieter-Referenzzeilen auf der ToAPIs Preisseite dienen nur der Anzeige und können von der Abrechnung Ihres Kontos abweichen.
    • Ein Angebot ist keine Kanalgarantie. Die 1.5-Referenz merkt an, dass ein erfolgreiches Preisangebot nicht bedeutet, dass ein Generierungskanal verfügbar ist.
    • Steuern Sie die Kosten in der Prompt-Ebene: Entwerfen Sie in 720p und mittlerer Dauer wie 8 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: grok-video-3 ist keine aktuelle öffentliche Katalog-ID; beginnen Sie mit grok-video-1.5 oder grok-video-1.0; behandeln Sie die 1.0-Dauergrenze als kanalspezifische Prüfung; synchronisiertes Audio ist nicht dokumentiert; fragen Sie immer den Generierungs-Status-Pfad ab und speichern Sie die Task-ID.


    7. Aktionscheckliste

    • Erstellen Sie einen Schlüssel im ToAPIs Developer Portal.
    • Bestätigen Sie über GET /v1/models?type=video, dass grok-video-1.5 oder grok-video-1.0 für Ihren Schlüssel erscheint – senden Sie kein grok-video-3, solange es nicht später in dieser Liste und in der API-Referenz auftaucht.
    • Testen Sie den cURL-Ausschnitt kurz mit video_generation_mode: "text_to_video", duration: 8 und resolution: "720p".
    • Fragen Sie GET /v1/videos/generations/{id} mit einer begrenzten Frist ab und laden Sie das Ergebnis vor expires_at herunter.
    • Nächster Schritt: der Leitfaden zum OpenAI-kompatiblen Zugang, wenn Sie einen bestehenden Client auf ToAPIs zeigen lassen, der Grok Video 1.5 Modell-Leitfaden für den Live-Status im Katalog und der Grok Video 1.0 Modell-Leitfaden, bevor Sie sich bei dieser ID auf eine Dauer über 6 Sekunden verlassen.

    In diesem Beitrag erwähnte Modelle entdecken

    xAIVIDEO

    grok-video-1.0

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

    Grok Video 1.5

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

    Verwandte Artikel

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

    Zugang zur Grok-Video-3 API über OpenAI-kompatible Endpunkte

    Richten Sie einen OpenAI-kompatiblen Client auf ToAPIs, um die aktuellen Grok Video Katalog-IDs aufzurufen: gemeinsame Bearer-Authentifizierung und /v1 Basis-URL, mit Videojobs über POST /v1/videos/generations statt eines unveröffentlichten grok-video-3 Pfads.

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    tutorial2026-11-20T10:00:00+08:008 Min. Lesezeit

    Alibaba Wan 3.0 Video API: Getting Started with Next-Gen Video Generation

    A production quickstart for wan3.0-video and wan3.0-video-prime on ToAPIs: one All-in-One endpoint, first and last frames versus reference media, file or link references, video editing constraints, and the documented polling path.

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    tutorial2026-11-18T10:00:00+08:008 Min. Lesezeit

    Kling 3.0 Omni API Deep Dive: Multi-Shot Video Generation and Physics Coherence

    A hands-on guide to kling-v3-omni on ToAPIs: official Omni placeholders, image_list, video_list, and element_list, first and end frames, and the documented polling path — without an undocumented shots array.

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Omni
    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.