ToAPIs
    InícioToAPIs
    Geração de imagensGPT Image 2.6, Gemini, FLUX…Geração de vídeoSeedance, Veo, Kling, Sora…Chat e escritaGPT-5.6, Claude, DeepSeek…Voz e músicaLocuções, TTS, áudio
    NovidadeSeedance 2.5
    PreçosDocumentação da APIMCP
    BlogAlternativas
    EntrarComece grátis
    Todos os modelosPreçosDocumentação da APIMCPBlogAlternativas
    EntrarComece grátis

    Idioma

    Esc
    • Seedance 2.5Geração de vídeo
    • GPT Image 2Geração de imagens
    • GPT Image 2.6Geração de imagens
    • GPT Image 2.5Geração de imagens
    • Veo 3.1 FastGeração de vídeo
    • Kling 3.0 TurboGeração de vídeo
    • Kling V4 FlashGeração de vídeo
    • Grok Video 1.5Geração de vídeo
    • Nano Banana 2Geração de imagens
    • Seedream 5.5Geração de imagens
    • FLUXGeração de imagens
    • Sora 2Geração de vídeo
    • Todos os modelos de imagemCategoria
    • Todos os modelos de vídeoCategoria
    • GPT-5.6 SolChat e código
    • Claude Opus 4.8Chat e código
    • Claude Opus 4.7Chat e código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal
    1. Início
    2. Blog
    3. Tutorial
    4. Como acessar a API do Grok Video 3 por endpoints compatíveis com OpenAI
    Voltar a todos os artigos
    tutorial2026-11-176 min de leitura

    Como acessar a API do Grok Video 3 por endpoints compatíveis com OpenAI

    Aponte um cliente compatível com OpenAI para a ToAPIs e chame os IDs atuais do catálogo Grok Video: autenticação Bearer compartilhada e URL base /v1, com trabalhos de vídeo em POST /v1/videos/generations em vez de um caminho grok-video-3 não publicado.

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - Principais conclusões
    • A ToAPIs documenta uma URL base /v1 unificada compatível com OpenAI e uma chave de API Bearer. Os IDs de Grok Video listados hoje para esse endpoint openai-video são grok-video-1.0 e grok-video-1.5, não grok-video-3.
    • Liste os modelos de vídeo com GET /v1/models?type=video. A lista de modelos padrão retorna apenas modelos de texto; omitir o type esconde os IDs de Grok Video.
    • Crie e consulte trabalhos de vídeo com POST /v1/videos/generations e GET /v1/videos/generations/{id}. Esse é o contrato de vídeo documentado. Não presuma que exista na ToAPIs um método do SDK OpenAI Videos como client.videos.create, a menos que a documentação da sua conta indique isso.
    • Mantenha o mesmo cabeçalho Authorization em chat, uploads e vídeo. Para arquivos locais, faça upload com POST /v1/uploads/images e use a URL pública retornada.
    • Confirme a string exata do modelo e a tarifa vigente na sua conta. Uma URL base compatível não inventa um ID de modelo não publicado nem um preço unitário fixo.

    Como acessar a API do Grok Video 3 por endpoints compatíveis com OpenAI

    Modelos alvo: grok-video-1.5, grok-video-1.0
    Endpoint de inferência: https://api.toapis.com/v1/videos/generations
    Relacionado: Guia prático do Grok Video · API do canal oficial do Grok Imagine · Configuração compatível com OpenAI no Chatbox · Listar modelos


    1. Resumo e visão geral de desempenho

    • O que "compatível com OpenAI" significa aqui: a ToAPIs documenta uma única origem /v1, autenticação Bearer e uma lista de modelos e uma API de conclusões de chat no estilo OpenAI. Os IDs públicos de Grok Video estão registrados na família de endpoints openai-video do catálogo. Isso não significa que um ID grok-video-3 não publicado vai funcionar, e por si só não documenta um método do SDK OpenAI Videos.
    • IDs: use grok-video-1.5 ou grok-video-1.0 depois que eles aparecerem para a sua chave em GET /v1/models?type=video. O snapshot público do catálogo datado de 2026-11-10 não lista grok-video-3.
    • Caminho de vídeo: crie com POST /v1/videos/generations. Consulte com GET /v1/videos/generations/{id}. Os exemplos oficiais usam https://toapis.com (e https://toapis.cn para a China continental). Esta série também usa https://api.toapis.com.
    • Autenticação compartilhada: uma chave de API em Authorization: Bearer. Não existe um documento público separado de escopos OAuth para essas chamadas de vídeo.
    • Escolha de cliente: use o SDK da OpenAI contra base_url="https://api.toapis.com/v1" para trabalho no estilo chat e para uma configuração familiar de chave e origem. Para o Grok Video, este guia usa o corpo JSON REST documentado, para que video_generation_mode e os campos de URL de imagem fiquem explícitos.

    2. Origem compatível, lista de modelos e caminhos de vídeo

    Mantenha juntos a origem, o prefixo /v1 e a chave. Misturar uma chave da ToAPIs com https://api.openai.com/v1, ou uma origem da ToAPIs com um caminho nativo de Grok do fornecedor, é uma configuração diferente e não documentada.

    EtapaCaminho documentadoObservações
    Listar modelosGET /v1/models?type=videoO GET /v1/models padrão retorna apenas modelos de texto. Use type=video ou type=all
    Enviar uma imagem localPOST /v1/uploads/images (file em multipart)Leia data.url. Não envie base64 na chamada de geração
    Criar um trabalho de Grok VideoPOST /v1/videos/generationsO corpo inclui model, prompt e os campos de modo e mídia do 1.5
    Consultar statusGET /v1/videos/generations/{id}Os estados finais são completed e failed
    Chat (não vídeo)POST /v1/chat/completionsCompartilha apenas a origem e a chave

    No grok-video-1.5, defina video_generation_mode como text_to_video, first_frame_image_to_video ou reference_images_to_video para que o JSON corresponda à mídia enviada. O contrato campo a campo está no guia prático do Grok Video e na referência da API do Grok Video 1.5.

    Um painel de cliente compatível conectando por um gateway hexagonal aos caminhos de envio e de consulta

    Figura 1: aponte o cliente para uma origem /v1 da ToAPIs, descubra grok-video-1.5 ou grok-video-1.0 com a lista de modelos e então envie e consulte em /v1/videos/generations — não em chat/completions.

    Se você está configurando um cliente de desktop em vez de código de aplicação, o guia de configuração do Chatbox cobre o padrão de campo de host para chat. Não espere que esse mesmo caminho de chat retorne um arquivo de vídeo.


    3. Implementação em produção: cURL e Python

    Os exemplos internacionais desta série usam https://api.toapis.com. A documentação oficial orienta usuários da China continental a usar https://toapis.cn. Mantenha uma origem por ambiente.

    Etapa 1: descubra o ID e então envie com 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"
      }'
    

    Inspecione a lista de modelos para ver a string id exata antes de fixá-la no código. Se grok-video-3 estiver ausente, não o envie.

    Etapa 2: Python, origem compartilhada e chamadas REST de vídeo

    O SDK da OpenAI aparece aqui apenas pela base_url e pela chave de API compartilhadas. A criação e a consulta de vídeo ficam nos caminhos de generations documentados, para que os campos do corpo do 1.5 não se percam em um mapeamento de cliente não oficial.

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

    Se a chamada de lista retornar um envelope inesperado, registre o JSON bruto e alinhe o parser com a página de Listar modelos da sua conta. Não invente uma alternativa que envie grok-video-3 quando o ID estiver ausente.


    4. Tratamento de erros e matriz de status

    As categorias abaixo são pontos de partida de diagnóstico, não uma garantia dos códigos de erro exatos da ToAPIs. Uma consulta HTTP bem-sucedida ainda exige ler o status da tarefa. Veja a referência de erros.

    Estado HTTP ou da tarefaCategoria comumAção recomendada
    400ID de modelo desconhecido, incompatibilidade entre modo e mídia, ou um corpo de vídeo enviado a um caminho de chatConfirme o ID em GET /v1/models?type=video, que você enviou para /v1/videos/generations e que os trabalhos 1.5 definem um video_generation_mode compatível
    401Chave de API ausente ou inválidaUse uma chave da ToAPIs, não uma chave da plataforma OpenAI, e confirme o cabeçalho Bearer
    404Origem errada, /v1 faltando ou um caminho inventado como /videos/tasks/{id}Mude para GET /v1/videos/generations/{id} na origem que você usou para enviar
    429Limite de taxa ou de concorrênciaRespeite Retry-After quando presente; recue com jitter
    5xx ou timeout do clienteProblema temporário de gateway ou upstreamConsulte o id da tarefa existente antes de reenviar
    status: failedA geração não teve sucessoLeia error.code e error.message. Não repita um payload rejeitado por política sem alterações

    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. Preços e ROI de 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

    • Compatibilidade não muda a SKU faturável. Você paga pelo ID de modelo do catálogo que envia (grok-video-1.5 ou grok-video-1.0), não por "usar o SDK da OpenAI".
    • Não reutilize preços unitários de rascunhos de planejamento. A referência do Grok Video 1.5 não garante um preço fixo por segundo. As linhas de referência oficiais do fornecedor na página de preços da ToAPIs são apenas informativas e podem não corresponder à cobrança da conta.
    • Um descobrimento que falha é barato; uma geração duplicada não é. Faça cache da lista de modelos por um curto período, mas sempre verifique o status da tarefa após um timeout do cliente antes de criar outro trabalho.
    • A cobrança da ToAPIs costuma ser por uso: confirme os termos ativos na sua conta.

    6. Perguntas frequentes

    Veja o bloco de perguntas frequentes no frontmatter. Resumo: uma URL base compatível não libera grok-video-3; inclua /v1 uma vez; consulte /v1/videos/generations/{id}; não presuma um helper videos.create do SDK; conclusões de chat não retornarão um MP4.


    7. Lista de ações

    • Crie uma chave no Portal do desenvolvedor da ToAPIs.
    • Aponte seu cliente para https://api.toapis.com/v1 (ou https://toapis.cn/v1 na China continental) com Authorization: Bearer.
    • Chame GET /v1/models?type=video e registre os IDs exatos de Grok Video que a sua chave enxerga.
    • Faça um teste rápido de POST /v1/videos/generations com grok-video-1.5 e video_generation_mode: "text_to_video", depois consulte o mesmo id.
    • Próximo passo: o guia prático do Grok Video para detalhes de modo e de campos de imagem, e o guia do modelo Grok Video 1.5 para o status do catálogo em tempo real.

    Explore os modelos mencionados neste artigo

    xAIVIDEO

    grok-video-1.0

    Taxa atual: 2 credits /second
    Guia do modeloTestar no consoleObter chave de API
    xAIVIDEO

    Grok Video 1.5

    Taxa atual: 3.824 credits /second
    Guia do modeloTestar no consoleObter chave de API

    Artigos relacionados

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

    Prática com a API do Grok-Video-3: tudo o que você precisa saber sobre o motor de vídeo da xAI

    Guia prático para chamar hoje o xAI Grok Video na ToAPIs: o catálogo público ainda lista grok-video-1.0 e grok-video-1.5, não grok-video-3, com o contrato atual de gerações, os modos e o caminho de sondagem.

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    tutorial2026-11-20T10:00:00+08:008 min de leitura

    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 leitura

    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
    InícioToAPIs
    Gateway empresarial de API de IA. Acesse GPT-5, Claude, Gemini e mais de 200 modelos por uma única API unificada.

    Modelos populares

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mostrar maisMostrar menos
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Todos os modelos

    Categorias de API

    • API de imagem com IA
    • API de vídeo com IA
    • API de texto para vídeo
    • API de imagem para vídeo
    Mostrar maisMostrar menos
    • API de edição de imagens com IA
    • API de LLM e raciocínio
    • Todas as ferramentas de API →

    Alternativas

    Alternativas
    • Alternativa ao Kie.ai
    • Alternativa ao Fal.ai
    • Alternativa ao OpenRouter
    • Alternativa ao Replicate
    • Alternativa ao Wavespeed AI
    • Todas as comparações →

    Guias em destaque

    Guias em destaque
    • Preços do Seedance 2.0 e 2.5
    • Guia da API Seedance mais barata
    • Guia de integração do MiniMax H3
    • Chave de API gratuita do Seedance 2
    • Início rápido da API Seedance 2
    • Todos os artigos técnicos →

    Desenvolvedores e plataforma

    Desenvolvedores e plataforma
    • Documentação da API
    • MCP
    • Preços
    • Playground de modelos
    • LLMs.txt
    • Falar com o suporte
    • Diretório de guias de modelos
    Entidade operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Sede social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadeTermosUso aceitávelExclusão de dadosRetenção de dadosSubprocessadores e regiõesCobrança e reembolsosPolítica de CookiesMapa do siteSobre

    © 2026 ToAPIs. Todos os direitos reservados.