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. Grok Imagine 1.0 Video Generation API: Endpunkte, Auth-Scopes und Fehlerbehandlung
    Zurück zu allen Beiträgen
    tutorial2026-11-176 Min. Lesezeit

    Grok Imagine 1.0 Video Generation API: Endpunkte, Auth-Scopes und Fehlerbehandlung

    Der aktuelle Grok Imagine Vertrag auf ToAPIs nutzt grok-imagine-video-official und grok-imagine-video-1.5-official: Bearer-Auth, Generierungs- und Extend-Endpunkte sowie dokumentierte Fehlerbehandlung. Es gibt keine grok-imagine-1.0 ID und keine OAuth-Scope-Matrix.

    ToAPIs Engineering & Evaluation Team
    Grok ImagineVideo APIAuthenticationError HandlingTutorial
    TL;DR - Wichtigste Punkte
    • Es gibt keine öffentliche Katalog-ID namens grok-imagine-1.0. Die dokumentierten IDs des offiziellen Kanals sind grok-imagine-video-official (Text, Bild und Mehrfachreferenz, plus Extend) und grok-imagine-video-1.5-official (nur First-Frame-Image-to-Video, bis 1080p, kein Extend).
    • Die dokumentierte Authentifizierung ist ein Bearer-API-Key im Authorization-Header. Dieser Artikel fand keine öffentliche OAuth-Scope-Matrix (etwa videos:write) für diese Endpunkte.
    • Erstellen Sie Jobs mit POST /v1/videos/generations und fragen Sie GET /v1/videos/generations/{id} ab. Verlängern Sie Clips des offiziellen Kanals mit POST /v1/videos/{video_id}/extend oder POST /v1/videos/extend plus video_urls für 2–10 zusätzliche Sekunden.
    • Laden Sie lokale Bilder mit POST /v1/uploads/images hoch und senden Sie nur öffentliche URLs. official erlaubt bis zu 7 Bilder über image und reference_images; 1.5-official verlangt genau ein Startbild und dokumentiert keine Videoverlängerung.
    • Die Ausgabe wird pro Sekunde nach Auflösungsstufe abgerechnet; Eingabebilder werden pro Bild abgerechnet; Extend rechnet zusätzlich die Dauer des Quellvideos ab. Bestätigen Sie die Live-Tarife Ihres Kontos – verwenden Sie keine Stückpreise aus Entwürfen erneut.

    Grok Imagine 1.0 Video Generation API: Endpunkte, Auth-Scopes und Fehlerbehandlung

    Zielmodelle: grok-imagine-video-official, grok-imagine-video-1.5-official
    Inferenz-Endpunkt: https://api.toapis.com/v1/videos/generations
    Verwandt: Praxisleitfaden Grok Video · OpenAI-kompatibler Zugang · Offizielle Imagine-Generierung · Offizielles Imagine Extend


    1. Kurzüberblick und Leistungsübersicht

    • IDs: Anfragen, die um „Grok Imagine 1.0“ herum betitelt sind, benötigen die Zeichenketten, die ToAPIs tatsächlich veröffentlicht. Die öffentliche Katalog-Momentaufnahme vom 2026-11-10 listet grok-imagine-video-official und grok-imagine-video-1.5-official (beide erscheinen auch unter Bildgenerierung sowie unter openai-video). Eine Prüfung vom 2026-11-17 eines grok-imagine-1.0-Dokumentationspfads ergab HTTP 404.
    • Auth: Senden Sie Authorization: Bearer $TOAPIS_API_KEY. Die offiziellen Seiten dokumentieren keine OAuth-Scopes, granularen Berechtigungsnamen oder einen Scope-Discovery-Endpunkt für diese Aufrufe.
    • Endpunkte: Erstellen mit POST /v1/videos/generations. Abfragen mit GET /v1/videos/generations/{id}. Verlängern Sie die Ausgabe des offiziellen Kanals mit POST /v1/videos/{video_id}/extend oder mit POST /v1/videos/extend plus video_urls, wenn Sie nur eine öffentliche Video-URL haben. Laden Sie Standbilder mit POST /v1/uploads/images hoch.
    • Fähigkeiten: grok-imagine-video-official deckt Text-zu-Video, Bild-zu-Video und Mehrfachreferenz-Generierung bei 480p oder 720p ab, Dauer 1–15 Sekunden, und Extend um 2–10 Sekunden. grok-imagine-video-1.5-official ist ausschließlich First-Frame-Image-to-Video, verlangt genau ein image, erlaubt 1080p und unterstützt kein Extend.
    • Preisform (kein fester Stückpreis auf den Referenzseiten): Ausgabe wird pro Sekunde nach Auflösung abgerechnet; jedes Eingabebild wird pro Bild abgerechnet; Extend rechnet zusätzlich die Dauer des Quellvideos ab. Bestätigen Sie die Live-Tarife Ihres Kontos.

    2. Endpunkte, Authentifizierung und Modellverträge

    Die offizielle Dokumentation verwendet 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. Jeder Pfad unten nutzt denselben Bearer-Header.

    AktionMethode und PfadModellhinweise
    Standbild hochladenPOST /v1/uploads/imagesMultipart-file. JPEG, PNG, WebP oder GIF, maximal 30 MB. data.url auslesen
    Video erstellenPOST /v1/videos/generationsBeide offiziellen Imagine-IDs
    Status abfragenGET /v1/videos/generations/{id}Gleicher Pfad für Generierungs- und Extend-Tasks
    Aus vorherigem Task verlängernPOST /v1/videos/{video_id}/extendNur grok-imagine-video-official. video_id ist die ID des vorherigen Generierungs-Tasks
    Aus öffentlicher URL verlängernPOST /v1/videos/extendGleiche offizielle ID; video_urls ist erforderlich, wenn kein Pfad-ID vorhanden ist
    Katalog-IDDokumentierte JobsDauerAuflösungBilderExtend
    grok-imagine-video-officialText-zu-Video, Startbild und Mehrfachreferenz1–15 Sekunden (Standard 8)480p, 720pOptionales image plus reference_images; bis zu 7 insgesamt2–10 Sekunden (duration Standard 6)
    grok-imagine-video-1.5-officialAusschließlich First-Frame-Image-to-Video1–15 Sekunden (Standard 8)480p, 720p, 1080pimage ist erforderlich (genau ein Startbild). Zusätzliche reference_images zählen weiter zum 7-Bilder-GesamtlimitNicht unterstützt

    Seitenverhältniswerte in den offiziellen Imagine-Referenzen umfassen 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 und 1:1. Senden Sie einen Wert, den Sie für diese ID und diesen Kanal bestätigt haben.

    Es gibt keine dokumentierte öffentliche Scope-Zeichenkette, um „generieren“, „verlängern“ oder „hochladen“ separat anzufordern. Der Zugang ist das, was API-Schlüssel, Benutzergruppe und Kanal-Konfiguration bereits erlauben. Wenn ein Aufruf aus Berechtigungs- oder Verfügbarkeitsgründen fehlschlägt, prüfen Sie die Modellliste des Schlüssels und die Fehlerreferenz, statt einen erfundenen scope-Query-Parameter anzuhängen.

    Ein Credential-Knoten, der durch ein hexagonales Gateway in drei Endpunkt-Kacheln läuft

    Abbildung 1: Ein einziger Bearer-API-Key autorisiert Upload, Generierung oder Extend und Statusabfrage; die offizielle 1.5-ID fügt keinen Extend-Zweig hinzu.

    Für die nicht offizielle Grok Video Familie (grok-video-1.0 / grok-video-1.5) siehe den Praxisleitfaden Grok Video. Diese IDs sind ein anderer Vertrag und erben diesen Extend-Pfad nicht.


    3. Produktionsumsetzung: cURL und Python

    Schritt 1: cURL – Text-zu-Video im offiziellen Kanal

    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-imagine-video-official",
        "prompt": "A golden retriever running on a green field in sunny weather",
        "duration": 10,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      }'
    

    Ein Startbild-Job auf grok-imagine-video-1.5-official nutzt denselben Pfad, verlangt "image": "https://example.com/portrait.jpg" und kann "resolution": "1080p" setzen. Ersetzen Sie die Beispiel-URL durch eine öffentliche Adresse – laden Sie die Datei zuerst hoch, wenn sie lokal ist:

    bash
    curl -X POST "https://api.toapis.com/v1/uploads/images" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -F "file=@/path/to/first-frame.jpg"
    

    Schritt 2: Python – generieren, abfragen und optional verlängern

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_imagine(
        prompt: str,
        *,
        model: str = "grok-imagine-video-official",
        duration: int = 10,
        resolution: str = "720p",
        aspect_ratio: str = "16:9",
        image_url: str | None = None,
        reference_images: list[str] | None = None,
    ) -> str:
        if model == "grok-imagine-video-1.5-official" and not image_url:
            raise ValueError("grok-imagine-video-1.5-official requires exactly one first-frame image")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "aspect_ratio": aspect_ratio,
        }
        if image_url:
            payload["image"] = image_url
        if reference_images:
            payload["reference_images"] = reference_images
        res = requests.post(
            f"{BASE}/v1/videos/generations",
            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) -> dict:
        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={"Authorization": f"Bearer {API_KEY}"}, 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
            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")
    
    
    def extend_official(source_task_id: str, prompt: str, duration: int = 6) -> str:
        if not (2 <= duration <= 10):
            raise ValueError("official extend duration is documented as 2-10 seconds")
        res = requests.post(
            f"{BASE}/v1/videos/{source_task_id}/extend",
            headers=HEADERS,
            json={
                "model": "grok-imagine-video-official",
                "prompt": prompt,
                "duration": duration,
            },
            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 extend envelope: {data}")
        return task_id
    
    
    if __name__ == "__main__":
        task_id = dispatch_imagine(
            "A golden retriever running on a green field in sunny weather",
            duration=10,
            resolution="720p",
        )
        print("Task:", task_id)
        result = poll_task(task_id)
        print("Video:", result["result"]["data"][0]["url"])
    

    Um aus einer öffentlichen MP4 statt einer Task-ID zu verlängern, nutzen Sie POST /v1/videos/extend mit demselben offiziellen Modell, Prompt, duration und einer video_urls-Liste. Rufen Sie Extend nicht mit grok-imagine-video-1.5-official auf.


    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. Die Fehlerreferenz unterscheidet Request-Fehler, error.reason-Werte fehlgeschlagener Tasks und Webhook-Payloads.

    HTTP- oder Task-ZustandHäufige KategorieEmpfohlene Maßnahme
    400Ungültiges Feld, fehlendes erforderliches image bei 1.5-official, Bilderanzahl überschritten oder Extend an ein Modell gesendet, das es nicht unterstütztPrüfen Sie die exakte offizielle ID, Dauer (1–15 bei Generierung, 2–10 bei Extend), Auflösung (1080p nur bei 1.5-official) und dass alle Medienwerte öffentliche URLs sind
    401Fehlender oder ungültiger API-SchlüsselRotieren Sie den Schlüssel und bestätigen Sie Authorization: Bearer. Fügen Sie keinen undokumentierten scope-Parameter als Workaround hinzu
    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: queued oder in_progressKein FehlerWarten und erneut abfragen
    status: failed mit content_policy_rejectedSicherheits- oder UrheberrechtsprüfungPrüfen Sie Prompt und jedes Referenzasset; konforme Eingaben können dennoch eine abgelehnte Ausgabe erzeugen
    status: failed mit insufficient_user_balance oder token_quota_exceededGuthaben oder Token-KontingentPrüfen Sie sowohl Guthaben als auch periodische Limits
    status: failed mit generation_timeout, model_unavailable oder service_busyUpstream-Timeout oder VerfügbarkeitPrüfen Sie zuerst die bestehende ID; wiederholen Sie dann mit Backoff nur, wenn der Task endgültig ist

    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

    Die offiziellen Imagine-Seiten zu Generierung und Extend beschreiben eine Abrechnungsform und keinen festen öffentlichen Stückpreis:

    Estimated cost=(output seconds×resolution rate)+(input images×per-image rate)+(extend source seconds×per-second rate)\text{Estimated cost} = (\text{output seconds} \times \text{resolution rate}) + (\text{input images} \times \text{per-image rate}) + (\text{extend source seconds} \times \text{per-second rate})Estimated cost=(output seconds×resolution rate)+(input images×per-image rate)+(extend source seconds×per-second rate)

    Verwenden Sie die für Ihr Konto und Ihre SKU zurückgegebenen Tarife und keine Entwurfszahlen.

    • grok-imagine-video-1.5-official enthält immer eine Eingabebild-Gebühr, weil ein Startbild erforderlich ist.
    • Extend ist keine kostenlose Fortsetzung. Die offizielle Extend-Abrechnung umfasst die generierten Verlängerungssekunden und die Dauer des Quellvideos. Gestapelte Extends rechnen daher die wachsende Quelllänge erneut ab – bestätigen Sie dieses Verhalten anhand eines Live-Angebots, bevor Sie eine Schleife bauen.
    • Verwenden Sie keine Stückpreise oder SLA-Werte aus Planungsentwürfen erneut. Offizielle Anbieter-Referenzzeilen auf der ToAPIs Preisseite dienen nur der Anzeige und können von der Kontoabrechnung abweichen.
    • Entwerfen Sie in 720p und mittlerer Dauer, ändern Sie jeweils nur eine Variable und senden Sie nach einer clientseitigen Zeitüberschreitung erst erneut, wenn Sie den Task-Status geprüft haben.

    6. Häufig gestellte Fragen

    Siehe den FAQ-Block im Frontmatter. Kurzfassung: Senden Sie grok-imagine-video-official oder grok-imagine-video-1.5-official, nicht grok-imagine-1.0; Auth ist ein Bearer-API-Key ohne öffentliche OAuth-Scope-Matrix; 1.5-official ist ausschließlich Startbild und kann nicht verlängern; die Extend-Dauer ist 2–10 Sekunden und rechnet die Quelllänge zusätzlich ab; unterscheiden Sie stets HTTP-Fehler von status: failed.


    7. Aktionscheckliste

    • Erstellen Sie einen Schlüssel im ToAPIs Developer Portal.
    • Bestätigen Sie über GET /v1/models?type=video, dass grok-imagine-video-official oder grok-imagine-video-1.5-official für Ihren Schlüssel erscheint.
    • Testen Sie eine offizielle Generierung in 720p kurz, fragen Sie GET /v1/videos/generations/{id} ab und laden Sie die Datei vor expires_at herunter.
    • Wenn Sie eine Fortsetzung benötigen, verlängern Sie nur mit grok-imagine-video-official und einer duration von 2–10 Sekunden und bestätigen Sie anschließend, dass das Angebot die Abrechnung der Quell-Dauer einschließt.
    • Nächster Schritt: der offizielle Imagine Modell-Leitfaden und der offizielle Imagine 1.5 Modell-Leitfaden für den Live-Status im Katalog, und der Praxisleitfaden Grok Video, falls Sie die nicht offizielle grok-video-* Familie gemeint haben.

    In diesem Beitrag erwähnte Modelle entdecken

    xAIVIDEO

    grok-imagine-video-official

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

    grok-imagine-video-1.5-official

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

    Verwandte Artikel

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