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. Zugang zur Grok-Video-3 API über OpenAI-kompatible Endpunkte
    Zurück zu allen Beiträgen
    tutorial2026-11-175 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.

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - Wichtigste Punkte
    • ToAPIs dokumentiert eine einheitliche, OpenAI-kompatible /v1 Basis-URL und einen Bearer-API-Schlüssel. Die für diesen openai-video Endpunkt derzeit gelisteten Grok Video IDs sind grok-video-1.0 und grok-video-1.5, nicht grok-video-3.
    • Listen Sie Videomodelle mit GET /v1/models?type=video auf. Die Standard-Modellliste liefert nur Textmodelle; ohne type werden Grok Video IDs ausgeblendet.
    • Erstellen und Abfragen von Videojobs mit POST /v1/videos/generations und GET /v1/videos/generations/{id}. Das ist der dokumentierte Videovertrag. Gehen Sie nicht davon aus, dass eine OpenAI Videos SDK-Methode wie client.videos.create bei ToAPIs existiert, solange Ihre Kontodokumentation das nicht sagt.
    • Behalten Sie denselben Authorization-Header für Chat, Uploads und Video. Laden Sie lokale Assets mit POST /v1/uploads/images hoch und verwenden Sie die zurückgegebene öffentliche URL.
    • Bestätigen Sie die exakte Modellzeichenkette und den aktuellen Tarif in Ihrem Konto. Eine kompatible Basis-URL erfindet keine unveröffentlichte Modell-ID und keinen festen Stückpreis.

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

    Zielmodelle: grok-video-1.5, grok-video-1.0
    Inferenz-Endpunkt: https://api.toapis.com/v1/videos/generations
    Verwandt: Praxis-Guide zu Grok Video · API des offiziellen Grok Imagine Kanals · Chatbox OpenAI-kompatible Einrichtung · Modelle auflisten


    1. Kurzüberblick und Leistungsübersicht

    • Was „OpenAI-kompatibel“ hier bedeutet: ToAPIs dokumentiert einen einzigen /v1 Ursprung, Bearer-Authentifizierung sowie eine Modellliste und Chat-Completions-API im OpenAI-Stil. Öffentliche Grok Video IDs sind in der openai-video Endpunktfamilie des Katalogs registriert. Das bedeutet nicht, dass eine unveröffentlichte grok-video-3 ID funktioniert, und es dokumentiert für sich genommen keine OpenAI Videos SDK-Methode.
    • IDs: Verwenden Sie grok-video-1.5 oder grok-video-1.0, nachdem sie für Ihren Schlüssel in GET /v1/models?type=video erscheinen. Die öffentliche Katalog-Momentaufnahme vom 2026-11-10 listet grok-video-3 nicht.
    • Videopfad: Erstellen mit POST /v1/videos/generations. Abfragen mit GET /v1/videos/generations/{id}. Offizielle Beispiele verwenden https://toapis.com (und https://toapis.cn für Festlandchina). Diese Reihe verwendet auch https://api.toapis.com.
    • Gemeinsame Authentifizierung: Ein API-Schlüssel in Authorization: Bearer. Es gibt kein separates öffentliches OAuth-Scope-Dokument für diese Videoaufrufe.
    • Client-Wahl: Verwenden Sie das OpenAI SDK gegen base_url="https://api.toapis.com/v1" für Chat-Arbeit und für eine vertraute Schlüssel- und Ursprungskonfiguration. Für Grok Video nutzt dieser Guide den dokumentierten REST-JSON-Body, damit video_generation_mode und Bild-URL-Felder explizit bleiben.

    2. Kompatibler Ursprung, Modellliste und Videopfade

    Halten Sie Ursprung, /v1 Präfix und Schlüssel zusammen. Einen ToAPIs Schlüssel mit https://api.openai.com/v1 zu mischen oder einen ToAPIs Ursprung mit einem anbieternativen Grok-Pfad, ist eine andere – und undokumentierte – Konfiguration.

    SchrittDokumentierter PfadHinweise
    Modelle auflistenGET /v1/models?type=videoDas Standard-GET /v1/models liefert nur Textmodelle. Verwenden Sie type=video oder type=all
    Ein lokales Bild hochladenPOST /v1/uploads/images (multipart file)Lesen Sie data.url. Senden Sie kein base64 im Generierungsaufruf
    Einen Grok Video Job erstellenPOST /v1/videos/generationsDer Body enthält model, prompt und die 1.5 Modus- und Medienfelder
    Status abfragenGET /v1/videos/generations/{id}Endzustände sind completed und failed
    Chat (kein Video)POST /v1/chat/completionsTeilt nur Ursprung und Schlüssel

    Setzen Sie bei grok-video-1.5 video_generation_mode auf text_to_video, first_frame_image_to_video oder reference_images_to_video, damit das JSON zu den gesendeten Medien passt. Der Feldvertrag steht im Praxis-Guide zu Grok Video und in der Grok Video 1.5 API-Referenz.

    Ein kompatibles Client-Panel, das über ein hexagonales Gateway Send- und Abfragepfade erreicht

    Abbildung 1: Richten Sie den Client auf einen ToAPIs /v1 Ursprung, entdecken Sie grok-video-1.5 oder grok-video-1.0 über die Modellliste und senden und fragen Sie dann unter /v1/videos/generations ab – nicht unter chat/completions.

    Wenn Sie einen Desktop-Client statt Anwendungscode konfigurieren, beschreibt der Chatbox Einrichtungs-Guide das Host-Feld-Muster für Chat. Erwarten Sie nicht, dass derselbe Chat-Pfad eine Videodatei zurückgibt.


    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.

    Schritt 1: ID entdecken, dann mit cURL senden

    bash
    curl -sS "https://api.toapis.com/v1/models?type=video" \
      -H "Authorization: Bearer $TOAPIS_API_KEY"
    
    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"
      }'
    

    Prüfen Sie die Modellliste auf die exakte id Zeichenkette, bevor Sie sie fest verdrahten. Wenn grok-video-3 fehlt, senden Sie es nicht.

    Schritt 2: Python – gemeinsamer Ursprung, REST-Videoaufrufe

    Das OpenAI SDK wird nur für die gemeinsame base_url und den API-Schlüssel gezeigt. Video-Erstellung und -Abfrage bleiben auf den dokumentierten generations-Pfaden, damit die 1.5 Body-Felder nicht in einem inoffiziellen Client-Mapping verloren gehen.

    python
    import os
    import time
    import requests
    from openai import OpenAI
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    # Shared origin and key. Use this client for chat completions; do not assume
    # a videos.create mapping unless your account docs define one.
    client = OpenAI(base_url=f"{BASE}/v1", api_key=API_KEY)
    
    
    def list_video_model_ids() -> list[str]:
        res = requests.get(
            f"{BASE}/v1/models",
            headers=HEADERS,
            params={"type": "video"},
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        items = data.get("data") or data.get("models") or []
        return [item.get("id") or item.get("name") for item in items if item]
    
    
    def dispatch_grok_video(prompt: str, model: str = "grok-video-1.5") -> str:
        available = set(list_video_model_ids())
        if available and model not in available:
            raise ValueError(f"{model} is not in this key's video model list")
        res = requests.post(
            f"{BASE}/v1/videos/generations",
            headers=HEADERS,
            json={
                "model": model,
                "prompt": prompt,
                "video_generation_mode": "text_to_video",
                "duration": 8,
                "resolution": "720p",
                "aspect_ratio": "16:9",
            },
            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__":
        print("Video models (excerpt):", list_video_model_ids()[:20])
        task_id = dispatch_grok_video("A cinematic product shot with a slow camera push-in")
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Wenn der Listenaufruf eine unerwartete Struktur zurückgibt, protokollieren Sie das rohe JSON und gleichen Sie den Parser mit der Seite Modelle auflisten für Ihr Konto ab. Erfinden Sie keinen Ausweichweg, der grok-video-3 sendet, wenn die ID fehlt.


    4. Fehlerbehandlung und Statusmatrix

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

    HTTP- oder Task-ZustandHäufige KategorieEmpfohlene Maßnahme
    400Unbekannte Modell-ID, Modus-/Medien-Mismatch oder ein Video-Body, der an einen Chat-Pfad gesendet wurdeBestätigen Sie die ID in GET /v1/models?type=video, dass Sie an /v1/videos/generations gesendet haben und dass 1.5-Jobs einen passenden video_generation_mode setzen
    401Fehlender oder ungültiger API-SchlüsselVerwenden Sie einen ToAPIs Schlüssel, keinen OpenAI-Plattformschlüssel, und bestätigen Sie den Bearer-Header
    404Falscher Ursprung, fehlendes /v1 oder ein erfundener Pfad wie /videos/tasks/{id}Wechseln Sie zu GET /v1/videos/generations/{id} auf dem Ursprung, mit dem Sie gesendet haben
    429Rate- oder ParallelitätslimitBeachten Sie Retry-After, wenn vorhanden; weichen Sie mit Jitter zurück
    5xx oder clientseitige ZeitüberschreitungVorübergehendes Gateway- oder Upstream-ProblemFragen Sie die bestehende Task-ID ab, bevor Sie erneut senden
    status: failedGenerierung nicht erfolgreichLesen Sie error.code und error.message. 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

    • Kompatibilität ändert die abrechenbare SKU nicht. Abgerechnet wird die Katalog-Modell-ID, die Sie senden (grok-video-1.5 oder grok-video-1.0), nicht die „Nutzung des OpenAI SDK“.
    • Verwenden Sie keine Stückpreise aus Planungsentwürfen erneut. Die Grok Video 1.5 Referenz garantiert keinen festen Preis pro Sekunde. Offizielle Anbieter-Referenzzeilen auf der ToAPIs Preisseite dienen nur der Anzeige und können von der Kontoabrechnung abweichen.
    • Eine fehlgeschlagene Discovery ist günstig; eine doppelte Generierung nicht. Cachen Sie die Modellliste kurz, prüfen Sie aber nach einer clientseitigen Zeitüberschreitung immer den Task-Status, bevor Sie einen weiteren Job anlegen.
    • 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: eine kompatible Basis-URL schaltet grok-video-3 nicht frei; /v1 genau einmal angeben; GET /v1/videos/generations/{id} abfragen; keine SDK-Hilfsfunktion videos.create annehmen; Chat-Abschlüsse liefern kein MP4.


    7. Aktionscheckliste

    • Erstellen Sie einen Schlüssel im ToAPIs Developer Portal.
    • Richten Sie Ihren Client auf https://api.toapis.com/v1 (oder https://toapis.cn/v1 in Festlandchina) mit Authorization: Bearer.
    • Rufen Sie GET /v1/models?type=video auf und notieren Sie die exakten Grok Video IDs, die Ihr Schlüssel sieht.
    • Testen Sie kurz POST /v1/videos/generations mit grok-video-1.5 und video_generation_mode: "text_to_video" und fragen Sie dann dieselbe ID ab.
    • Nächster Schritt: der Praxis-Guide zu Grok Video für Details zu Modus und Bildfeldern und der Grok Video 1.5 Modell-Leitfaden für den Live-Status im Katalog.

    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:006 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.

    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:007 Min. Lesezeit

    Kling 3.0 Turbo API: Architecting High-Volume Short-Form Video Automation

    A production guide to kling-3.0-turbo on ToAPIs: documented duration and resolution ranges, first-frame-only image input, a bounded poll loop, and high-volume short-form automation without unverified draft prices.

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