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. Accéder à l'API Grok-Video-3 via des endpoints compatibles OpenAI
    Retour à tous les articles
    tutorial2026-11-176 min de lecture

    Accéder à l'API Grok-Video-3 via des endpoints compatibles OpenAI

    Pointez un client compatible OpenAI vers ToAPIs pour appeler les IDs actuels du catalogue Grok Video : authentification Bearer partagée et URL de base /v1, avec les tâches vidéo sur POST /v1/videos/generations plutôt qu'un chemin grok-video-3 non publié.

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - Points clés
    • ToAPIs documente une URL de base /v1 unifiée compatible OpenAI et une clé API Bearer. Les IDs Grok Video actuellement listés pour cet endpoint openai-video sont grok-video-1.0 et grok-video-1.5, pas grok-video-3.
    • Listez les modèles vidéo avec GET /v1/models?type=video. La liste par défaut ne renvoie que des modèles texte ; omettre type masque les IDs Grok Video.
    • Créez et interrogez les tâches vidéo avec POST /v1/videos/generations et GET /v1/videos/generations/{id}. C'est le contrat vidéo documenté. Ne supposez pas qu'une méthode du SDK OpenAI Videos comme client.videos.create existe sur ToAPIs, sauf si la documentation de votre compte l'indique.
    • Conservez le même en-tête Authorization pour le chat, les uploads et la vidéo. Pour les fichiers locaux, téléversez avec POST /v1/uploads/images et transmettez l'URL publique renvoyée.
    • Confirmez la chaîne de modèle exacte et le tarif en vigueur sur votre compte. Une URL de base compatible n'invente ni un ID de modèle non publié ni un prix unitaire fixe.

    Accéder à l'API Grok-Video-3 via des endpoints compatibles OpenAI

    Modèles cibles : grok-video-1.5, grok-video-1.0
    Point de terminaison d'inférence : https://api.toapis.com/v1/videos/generations
    Articles liés : Guide pratique Grok Video · API du canal officiel Grok Imagine · Configuration Chatbox compatible OpenAI · Lister les modèles


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

    • Ce que signifie « compatible OpenAI » ici : ToAPIs documente une origine /v1 unique, une authentification Bearer, ainsi qu'une liste de modèles et une API de complétions de chat au style OpenAI. Les IDs publics de Grok Video sont enregistrés dans la famille d'endpoints openai-video du catalogue. Cela ne signifie pas qu'un ID grok-video-3 non publié fonctionnera, et cela ne documente pas en soi une méthode du SDK OpenAI Videos.
    • IDs : utilisez grok-video-1.5 ou grok-video-1.0 après qu'ils apparaissent pour votre clé dans GET /v1/models?type=video. L'instantané public du catalogue daté du 2026-11-10 ne liste pas grok-video-3.
    • Chemin vidéo : créez avec POST /v1/videos/generations. Interrogez avec GET /v1/videos/generations/{id}. Les exemples officiels utilisent https://toapis.com (et https://toapis.cn pour la Chine continentale). Cette série utilise aussi https://api.toapis.com.
    • Authentification partagée : une clé API dans Authorization: Bearer. Il n'existe pas de document public distinct de portées OAuth pour ces appels vidéo.
    • Choix du client : utilisez le SDK OpenAI avec base_url="https://api.toapis.com/v1" pour le travail de type chat et pour une configuration familière de clé et d'origine. Pour Grok Video, ce guide utilise le corps JSON REST documenté afin que video_generation_mode et les champs d'URL d'image restent explicites.

    2. Origine compatible, liste de modèles et chemins vidéo

    Gardez ensemble l'origine, le préfixe /v1 et la clé. Mélanger une clé ToAPIs avec https://api.openai.com/v1, ou une origine ToAPIs avec un chemin Grok natif du fournisseur, correspond à une configuration différente — et non documentée.

    ÉtapeChemin documentéRemarques
    Lister les modèlesGET /v1/models?type=videoLe GET /v1/models par défaut ne renvoie que des modèles texte. Utilisez type=video ou type=all
    Téléverser une image localePOST /v1/uploads/images (file en multipart)Lisez data.url. N'envoyez pas de base64 dans l'appel de génération
    Créer une tâche Grok VideoPOST /v1/videos/generationsLe corps inclut model, prompt et les champs de mode et de média du 1.5
    Interroger le statutGET /v1/videos/generations/{id}Les états terminaux sont completed et failed
    Chat (pas vidéo)POST /v1/chat/completionsPartage seulement l'origine et la clé

    Sur grok-video-1.5, définissez video_generation_mode sur text_to_video, first_frame_image_to_video ou reference_images_to_video pour que le JSON corresponde aux médias envoyés. Le contrat champ par champ se trouve dans le guide pratique Grok Video et la référence API Grok Video 1.5.

    Un panneau client compatible se connectant via une passerelle hexagonale aux chemins de soumission et d'interrogation

    Figure 1 : pointez le client vers une origine /v1 ToAPIs, découvrez grok-video-1.5 ou grok-video-1.0 avec la liste des modèles, puis soumettez et interrogez sur /v1/videos/generations — pas sur chat/completions.

    Si vous configurez un client de bureau plutôt que du code applicatif, le guide de configuration Chatbox couvre le schéma du champ d'hôte pour le chat. N'attendez pas de ce même chemin chat qu'il renvoie un fichier vidéo.


    3. Implémentation en production : cURL et Python

    Les exemples internationaux de cette série utilisent https://api.toapis.com. La documentation officielle indique aux utilisateurs de Chine continentale d'utiliser https://toapis.cn. Gardez une origine par environnement.

    Étape 1 : découvrir l'ID, puis envoyer avec cURL

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

    Inspectez la liste des modèles pour la chaîne id exacte avant de la coder en dur. Si grok-video-3 est absent, ne l'envoyez pas.

    Étape 2 : Python — origine partagée, appels vidéo REST

    Le SDK OpenAI n'est montré que pour la base_url et la clé API partagées. La création et l'interrogation vidéo restent sur les chemins generations documentés, afin que les champs du corps 1.5 ne se perdent pas dans un mapping client non officiel.

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

    Si l'appel de liste renvoie une enveloppe inattendue, journalisez le JSON brut et alignez le parseur sur la page Lister les modèles de votre compte. N'inventez pas de repli qui envoie grok-video-3 lorsque l'ID est absent.


    4. Gestion des erreurs et matrice des statuts

    Les catégories ci-dessous sont des points de départ pour le diagnostic, pas 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. Voir la référence des erreurs.

    État HTTP ou de tâcheCatégorie couranteAction recommandée
    400ID de modèle inconnu, inadéquation mode/média ou corps vidéo envoyé à un chemin chatConfirmez l'ID dans GET /v1/models?type=video, que vous avez posté sur /v1/videos/generations et que les tâches 1.5 définissent un video_generation_mode cohérent
    401Clé API absente ou invalideUtilisez une clé ToAPIs, pas une clé de la plateforme OpenAI, et confirmez l'en-tête Bearer
    404Mauvaise origine, /v1 manquant ou chemin inventé comme /videos/tasks/{id}Passez à GET /v1/videos/generations/{id} sur l'origine utilisée pour la soumission
    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 passerelle ou d'amontInterrogez l'id de tâche existant avant de resoumettre
    status: failedLa génération n'a pas aboutiLisez error.code et error.message. Ne réessayez pas une charge utile rejetée par politique sans modification

    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

    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

    • La compatibilité ne change pas la SKU facturable. Vous êtes facturé pour l'ID de modèle du catalogue que vous envoyez (grok-video-1.5 ou grok-video-1.0), pas pour « l'utilisation du SDK OpenAI ».
    • Ne réutilisez pas les prix unitaires des brouillons de planification. La référence Grok Video 1.5 ne garantit pas de prix fixe à la seconde. Les lignes de référence officielles du fournisseur sur la page de tarifs ToAPIs sont purement indicatives et peuvent ne pas correspondre à la facturation du compte.
    • Une découverte ratée coûte peu ; une génération en double non. Mettez en cache la liste des modèles pour une courte période, mais vérifiez toujours l'état de la tâche après une expiration côté client avant de créer une autre tâche.
    • La facturation ToAPIs est généralement un paiement à l'usage — confirmez les conditions actives de votre compte.

    6. Questions fréquentes

    Voir le bloc FAQ du frontmatter. En résumé : une URL de base compatible ne débloque pas grok-video-3 ; incluez /v1 une seule fois ; interrogez /v1/videos/generations/{id} ; ne supposez pas d'assistant videos.create du SDK ; les complétions de chat ne renverront pas un MP4.


    7. Liste d'actions

    • Créez une clé sur le portail développeur ToAPIs.
    • Pointez votre client vers https://api.toapis.com/v1 (ou https://toapis.cn/v1 en Chine continentale) avec Authorization: Bearer.
    • Appelez GET /v1/models?type=video et notez les IDs Grok Video exacts que votre clé peut voir.
    • Testez rapidement POST /v1/videos/generations avec grok-video-1.5 et video_generation_mode: "text_to_video", puis interrogez le même id.
    • Étape suivante : le guide pratique Grok Video pour les détails de mode et de champs image, et le guide du modèle Grok Video 1.5 pour l'état du catalogue en production.

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

    xAIVIDEO

    grok-video-1.0

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

    Grok Video 1.5

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

    Articles associés

    tutorial2026-11-17T10:00:00+08:007 min de lecture

    Prise en main de l'API Grok-Video-3 : tout savoir sur le moteur vidéo de xAI

    Guide pratique pour appeler xAI Grok Video sur ToAPIs : le catalogue public liste toujours grok-video-1.0 et grok-video-1.5, pas grok-video-3, avec le contrat de générations actuel, les modes et le chemin d'interrogation.

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