ToAPIs
    AccueilToAPIs
    Génération d'imagesGPT Image 2.6, Gemini, FLUX…Génération de vidéosSeedance, Veo, Kling, Sora…Chat et rédactionGPT-5.6, Claude, DeepSeek…Voix et musiqueVoix off, TTS, audio
    Nouvelle sortieSeedance 2.5
    TarifsDocumentation APIMCP
    BlogAlternatives
    Se connecterCommencer gratuitement
    Tous les modèlesTarifsDocumentation APIMCPBlogAlternatives
    Se connecterCommencer gratuitement

    Langue

    Esc
    • Seedance 2.5Génération de vidéos
    • GPT Image 2Génération d'images
    • GPT Image 2.6Génération d'images
    • GPT Image 2.5Génération d'images
    • Veo 3.1 FastGénération de vidéos
    • Kling 3.0 TurboGénération de vidéos
    • Kling V4 FlashGénération de vidéos
    • Grok Video 1.5Génération de vidéos
    • Nano Banana 2Génération d'images
    • Seedream 5.5Génération d'images
    • FLUXGénération d'images
    • Sora 2Génération de vidéos
    • Tous les modèles d'imageCatégorie
    • Tous les modèles vidéoCatégorie
    • GPT-5.6 SolChat et codage
    • Claude Opus 4.8Chat et codage
    • Claude Opus 4.7Chat et codage
    • DeepSeek V4 ProDeepSeek · Texte
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Accueil
    2. Blog
    3. Tutoriel
    4. API de génération vidéo Grok Imagine 1.0 : points de terminaison, scopes d'authentification et gestion des erreurs
    Retour à tous les articles
    tutorial2026-11-177 min de lecture

    API de génération vidéo Grok Imagine 1.0 : points de terminaison, scopes d'authentification et gestion des erreurs

    Le contrat Grok Imagine actuel sur ToAPIs utilise grok-imagine-video-official et grok-imagine-video-1.5-official : auth Bearer, points de terminaison generations et extend, gestion documentée des erreurs. Il n'existe ni ID grok-imagine-1.0 ni matrice de scopes OAuth.

    ToAPIs Engineering & Evaluation Team
    Grok ImagineVideo APIAuthenticationError HandlingTutorial
    TL;DR - Points clés
    • Il n'existe aucun ID public de catalogue nommé grok-imagine-1.0. Les IDs documentés du canal officiel sont grok-imagine-video-official (texte, image et multi-référence, plus extend) et grok-imagine-video-1.5-official (image vers vidéo avec première image uniquement, jusqu'à 1080p, sans extend).
    • L'authentification documentée est une clé API Bearer dans l'en-tête Authorization. Cet article n'a pas trouvé de matrice publique de scopes OAuth (par exemple videos:write) pour ces points de terminaison.
    • Créez des tâches avec POST /v1/videos/generations et interrogez GET /v1/videos/generations/{id}. Prolongez les clips du canal officiel avec POST /v1/videos/{video_id}/extend ou POST /v1/videos/extend plus video_urls, pour 2 à 10 secondes supplémentaires.
    • Téléversez les images locales avec POST /v1/uploads/images et n'envoyez que des URL publiques. official autorise jusqu'à 7 images entre image et reference_images ; 1.5-official exige exactement une image de première image et ne documente pas l'extension vidéo.
    • La sortie est facturée à la seconde selon le palier de résolution ; les images d'entrée sont facturées par image ; extend facture aussi la durée de la vidéo source. Confirmez les tarifs en vigueur de votre compte — ne réutilisez pas les prix unitaires de brouillon.

    API de génération vidéo Grok Imagine 1.0 : points de terminaison, scopes d'authentification et gestion des erreurs

    Modèles cibles : grok-imagine-video-official, grok-imagine-video-1.5-official
    Point de terminaison d'inférence : https://api.toapis.com/v1/videos/generations
    Articles liés : Guide pratique Grok Video · Accès compatible OpenAI · Génération Imagine officielle · Extend Imagine officiel


    1. Résumé et vue d'ensemble des performances

    • IDs : les requêtes intitulées « Grok Imagine 1.0 » ont besoin des chaînes que ToAPIs publie réellement. L'instantané public du catalogue daté du 2026-11-10 liste grok-imagine-video-official et grok-imagine-video-1.5-official (ces deux apparaissent aussi sous génération d'images ainsi que sous openai-video). Une vérification du 2026-11-17 d'un chemin de documentation grok-imagine-1.0 a renvoyé HTTP 404.
    • Auth : envoyez Authorization: Bearer $TOAPIS_API_KEY. Les pages officielles ne documentent ni scopes OAuth, ni noms de permissions granulaires, ni point de terminaison de découverte de scopes pour ces appels.
    • Points de terminaison : créez avec POST /v1/videos/generations. Interrogez avec GET /v1/videos/generations/{id}. Prolongez la sortie du canal officiel avec POST /v1/videos/{video_id}/extend, ou avec POST /v1/videos/extend plus video_urls lorsque vous n'avez qu'une URL publique de vidéo. Téléversez des images fixes avec POST /v1/uploads/images.
    • Capacités : grok-imagine-video-official couvre texte vers vidéo, image vers vidéo et génération multi-référence en 480p ou 720p, durée 1–15 secondes, et extend de 2–10 secondes. grok-imagine-video-1.5-official est uniquement image vers vidéo avec première image, exige exactement une image, autorise 1080p et ne prend pas en charge extend.
    • Forme du prix (aucun prix unitaire fixe sur les pages de référence) : la sortie est facturée à la seconde selon la résolution ; chaque image d'entrée est facturée par image ; extend facture aussi la durée de la vidéo source. Confirmez les tarifs en vigueur de votre compte.

    2. Points de terminaison, authentification et contrats de modèle

    La documentation officielle utilise https://toapis.com (et https://toapis.cn pour la Chine continentale). D'autres guides de cette série utilisent https://api.toapis.com. Choisissez une origine et restez cohérent. Chaque chemin ci-dessous utilise le même en-tête Bearer.

    ActionMéthode et cheminNotes de modèle
    Téléverser une image fixePOST /v1/uploads/imagesfile multipart. JPEG, PNG, WebP ou GIF, 30 Mo maximum. Lire data.url
    Créer une vidéoPOST /v1/videos/generationsLes deux IDs Imagine officiels
    Interroger le statutGET /v1/videos/generations/{id}Même chemin pour les tâches de génération et d'extend
    Prolonger depuis une tâche antérieurePOST /v1/videos/{video_id}/extendgrok-imagine-video-official uniquement. video_id est l'id de la tâche de génération précédente
    Prolonger depuis une URL publiquePOST /v1/videos/extendMême ID officiel ; video_urls est requis lorsqu'il n'y a pas d'id dans le chemin
    ID de catalogueTâches documentéesDuréeRésolutionImagesExtend
    grok-imagine-video-officialTexte vers vidéo, première image et multi-référence1–15 secondes (par défaut 8)480p, 720pimage facultative plus reference_images ; jusqu'à 7 au total2–10 secondes (duration par défaut 6)
    grok-imagine-video-1.5-officialImage vers vidéo avec première image uniquement1–15 secondes (par défaut 8)480p, 720p, 1080pimage est obligatoire (exactement une première image). Les reference_images supplémentaires comptent toujours dans le total de 7 imagesNon pris en charge

    Les valeurs de ratio dans les références Imagine officielles incluent 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 et 1:1. Envoyez une valeur que vous avez confirmée pour cet ID et ce canal.

    Il n'existe aucune chaîne de scope publique documentée pour demander « générer », « prolonger » ou « téléverser » séparément. L'accès correspond à ce que la clé API, le groupe d'utilisateurs et la configuration du canal autorisent déjà. Si un appel échoue pour une raison de permission ou de disponibilité, consultez la liste de modèles de la clé et la référence des erreurs au lieu d'ajouter un paramètre de requête scope inventé.

    Un nœud d'identifiants traversant une gateway hexagonale vers trois tuiles de points de terminaison

    Figure 1 : une seule clé API Bearer autorise le téléversement, la génération ou l'extend et l'interrogation de statut ; l'ID officiel 1.5 n'ajoute pas de branche extend.

    Pour la famille Grok Video non officielle (grok-video-1.0 / grok-video-1.5), consultez le guide pratique Grok Video. Ces IDs relèvent d'un autre contrat et n'héritent pas de ce chemin extend.


    3. Implémentation en production : cURL et Python

    Étape 1 : cURL — texte vers vidéo sur le canal officiel

    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"
      }'
    

    Une tâche avec première image sur grok-imagine-video-1.5-official utilise le même chemin, exige "image": "https://example.com/portrait.jpg" et peut définir "resolution": "1080p". Remplacez l'URL d'exemple par une adresse publique — téléversez d'abord le fichier s'il est local :

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

    Étape 2 : Python — générer, interroger et extend facultatif

    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"])
    

    Pour prolonger depuis un MP4 public au lieu d'un id de tâche, utilisez POST /v1/videos/extend avec le même modèle officiel, le prompt, duration et une liste video_urls. N'appelez pas extend avec grok-imagine-video-1.5-official.


    4. Gestion des erreurs et matrice des statuts

    Les catégories ci-dessous sont des points de départ pour le diagnostic, et non une garantie des codes d'erreur exacts de ToAPIs. Une requête HTTP réussie exige toujours de lire le status de la tâche. La référence des erreurs distingue les erreurs de requête, les valeurs error.reason des tâches échouées et les payloads de webhook.

    État HTTP ou de tâcheCatégorie couranteAction recommandée
    400Champ invalide, image obligatoire manquante sur 1.5-official, dépassement du nombre d'images ou extend envoyé à un modèle qui ne le prend pas en chargeVérifiez l'ID officiel exact, la durée (1–15 en génération, 2–10 en extend), la résolution (1080p uniquement sur 1.5-official) et que toutes les valeurs de média sont des URL publiques
    401Clé API absente ou invalideFaites tourner la clé et confirmez Authorization: Bearer. N'ajoutez pas de paramètre scope non documenté comme contournement
    429Limite de débit ou de concurrenceRespectez Retry-After lorsqu'il est présent ; reculez avec du jitter
    5xx ou expiration côté clientProblème temporaire de gateway ou d'amontInterrogez l'id de tâche existant avant de resoumettre
    status: queued ou in_progressPas une erreurAttendez et interrogez à nouveau
    status: failed avec content_policy_rejectedContrôle de sécurité ou de droits d'auteurInspectez le prompt et chaque asset de référence ; une entrée conforme peut malgré tout produire une sortie rejetée
    status: failed avec insufficient_user_balance ou token_quota_exceededSolde ou quota de jetonsVérifiez à la fois le solde et les limites périodiques
    status: failed avec generation_timeout, model_unavailable ou service_busyExpiration ou disponibilité en amontVérifiez d'abord l'id existant ; ne réessayez avec backoff que si la tâche est terminale

    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. Tarifs et retour sur investissement FinOps

    Les pages officielles de génération et d'extend d'Imagine décrivent une forme de facturation, pas un prix unitaire public fixe :

    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)

    Utilisez les tarifs renvoyés pour votre compte et votre SKU, pas des chiffres de brouillon.

    • grok-imagine-video-1.5-official inclut toujours une facturation d'image d'entrée, car une image de première image est obligatoire.
    • Extend n'est pas une continuation gratuite. La facturation extend officielle inclut les secondes d'extension générées et la durée de la vidéo source. Les extends empilés refacturent donc la longueur source croissante — confirmez ce comportement avec un devis en vigueur avant de construire une boucle.
    • Ne réutilisez pas les prix unitaires ni les chiffres de SLA des brouillons de planification. Les lignes de référence officielles du fournisseur sur la page de tarifs ToAPIs sont purement indicatives et peuvent différer de la facturation du compte.
    • Travaillez en 720p avec une durée intermédiaire, ne changez qu'une variable à la fois et ne resoumettez jamais après une expiration côté client tant que l'état de la tâche n'est pas vérifié.

    6. Questions fréquentes

    Voir le bloc FAQ du frontmatter. En résumé : envoyez grok-imagine-video-official ou grok-imagine-video-1.5-official, pas grok-imagine-1.0 ; l'authentification est une clé API Bearer sans matrice publique de scopes OAuth ; 1.5-official est uniquement première image et ne peut pas prolonger ; la durée extend est de 2 à 10 secondes et facture aussi la longueur source ; distinguez toujours les erreurs HTTP de status: failed.


    7. Liste d'actions

    • Créez une clé sur le portail développeur ToAPIs.
    • Confirmez que grok-imagine-video-official ou grok-imagine-video-1.5-official apparaît pour votre clé via GET /v1/models?type=video.
    • Testez rapidement une génération officielle en 720p, interrogez GET /v1/videos/generations/{id} et téléchargez le fichier avant expires_at.
    • Si vous avez besoin d'une continuation, prolongez uniquement avec grok-imagine-video-official et une duration de 2 à 10 secondes, puis confirmez que le devis inclut la facturation de la durée source.
    • Étape suivante : le guide officiel du modèle Imagine et le guide officiel du modèle Imagine 1.5 pour l'état du catalogue en production, et le guide pratique Grok Video si vous visiez la famille non officielle grok-video-*.

    Découvrir les modèles cités dans cet article

    xAIVIDEO

    grok-imagine-video-official

    Tarif actuel : 11.2 credits /second
    Guide du modèleEssayer dans la consoleObtenir une clé d'API
    xAIVIDEO

    grok-imagine-video-1.5-official

    Tarif actuel : 22.4 credits /second
    Guide du modèleEssayer dans la consoleObtenir une clé d'API

    Articles associés

    tutorial2026-11-20T10:00:00+08:008 min de lecture

    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 de lecture

    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 de lecture

    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
    AccueilToAPIs
    Passerelle d'API d'IA pour l'entreprise. Accédez à GPT-5, Claude, Gemini et plus de 200 modèles via une API unifiée.

    Modèles populaires

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Afficher plusAfficher moins
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Tous les modèles

    Catégories d'API

    • API image IA
    • API vidéo IA
    • API texte-vers-vidéo
    • API image-vers-vidéo
    Afficher plusAfficher moins
    • API d'édition d'image IA
    • API LLM et raisonnement
    • Tous les outils API →

    Alternatives

    Alternatives
    • Alternative à Kie.ai
    • Alternative à Fal.ai
    • Alternative à OpenRouter
    • Alternative à Replicate
    • Alternative à Wavespeed AI
    • Toutes les comparaisons →

    Guides à la une

    Guides à la une
    • Tarifs de Seedance 2.0 et 2.5
    • Guide de l'API Seedance la moins chère
    • Guide d'intégration de MiniMax H3
    • Clé d'API Seedance 2 gratuite
    • Démarrage rapide de l'API Seedance 2
    • Tous les articles techniques →

    Développeurs et plateforme

    Développeurs et plateforme
    • Documentation API
    • MCP
    • Tarifs
    • Playground de modèles
    • LLMs.txt
    • Contacter le support
    • Annuaire des guides de modèles
    Entité exploitante :
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Siège social :
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    ConfidentialitéConditionsUsage acceptableSuppression des donnéesConservation des donnéesSous-traitants et régionsFacturation et remboursementsPolitique relative aux cookiesPlan du siteÀ propos

    © 2026 ToAPIs. Tous droits réservés.