ToAPIs
    ГлавнаяToAPIs
    Генерация изображенийGPT Image 2.6, Gemini, FLUX…Генерация видеоSeedance, Veo, Kling, Sora…Чат и текстыGPT-5.6, Claude, DeepSeek…Речь и аудиоОзвучка, TTS, подкасты
    НовинкаSeedance 2.5
    ЦеныAPI ДокументацияMCP
    БлогАльтернативы
    ВойтиПопробовать
    Все моделиЦеныAPI ДокументацияMCPБлогАльтернативы
    ВойтиПопробовать

    Язык

    Esc
    • Seedance 2.5Генерация видео
    • GPT Image 2Генерация изображений
    • GPT Image 2.6Генерация изображений
    • GPT Image 2.5Генерация изображений
    • Veo 3.1 FastГенерация видео
    • Kling 3.0 TurboГенерация видео
    • Kling V4 FlashГенерация видео
    • Grok Video 1.5Генерация видео
    • Nano Banana 2Генерация изображений
    • Seedream 5.5Генерация изображений
    • FLUXГенерация изображений
    • Sora 2Генерация видео
    • Все модели изображенийКатегория
    • Все видеомоделиКатегория
    • GPT-5.6 SolЧат и код
    • Claude Opus 4.8Чат и код
    • Claude Opus 4.7Чат и код
    • DeepSeek V4 ProDeepSeek · Текст
    • Gemini Omni 1.1 FlashGoogle · Мультимодальная
    1. Главная
    2. Блог
    3. Руководства
    4. Как вызвать Grok Video 3 API через OpenAI-совместимые эндпоинты
    Назад ко всем статьям
    tutorial2026-11-175 мин чтения

    Как вызвать Grok Video 3 API через OpenAI-совместимые эндпоинты

    Направьте OpenAI-совместимый клиент на ToAPIs, чтобы вызывать актуальные каталожные ID Grok Video: общий Bearer-ключ и origin /v1, а видеозадания — через POST /v1/videos/generations, а не по неопубликованному пути grok-video-3.

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - Ключевые моменты
    • ToAPIs документирует единый OpenAI-совместимый origin /v1 и API-ключ Bearer. ID Grok Video, сейчас указанные для эндпоинта openai-video, — grok-video-1.0 и grok-video-1.5, а не grok-video-3.
    • Список видеомоделей получают через GET /v1/models?type=video. Список по умолчанию возвращает только текстовые модели; без type идентификаторы Grok Video скрыты.
    • Создавайте и опрашивайте видеозадания через POST /v1/videos/generations и GET /v1/videos/generations/{id}. Это документированный видеоконтракт. Не предполагайте метод SDK OpenAI Videos вроде client.videos.create на ToAPIs, пока документы вашего аккаунта не скажут иное.
    • Один и тот же заголовок Authorization используется для чата, загрузок и видео. Локальные файлы загружайте через POST /v1/uploads/images и передавайте возвращённый публичный URL.
    • Точную строку модели и живой тариф подтверждайте в аккаунте. Совместимый origin сам по себе не создаёт неопубликованный ID модели и не фиксирует удельную цену.

    Как вызвать Grok Video 3 API через OpenAI-совместимые эндпоинты

    Целевые модели: grok-video-1.5, grok-video-1.0
    Эндпоинт инференса: https://api.toapis.com/v1/videos/generations
    Связанные материалы: Практическое руководство по Grok Video · Официальный канал Grok Imagine · Настройка Chatbox · Список моделей


    1. Краткое содержание и обзор (TL;DR)

    • Что здесь значит «OpenAI-совместимость»: ToAPIs документирует единый origin /v1, аутентификацию Bearer, а также список моделей и chat completions в стиле OpenAI. Публичные ID Grok Video зарегистрированы в семействе эндпоинтов каталога openai-video. Это не означает, что неопубликованный grok-video-3 заработает, и не документирует само по себе метод OpenAI Videos SDK.
    • Идентификаторы: используйте grok-video-1.5 или grok-video-1.0 после появления для вашего ключа в GET /v1/models?type=video. Снимок публичного каталога от 2026-11-10 не содержит grok-video-3.
    • Видеопуть: создание — POST /v1/videos/generations. Опрос — GET /v1/videos/generations/{id}. Официальные примеры используют https://toapis.com (и https://toapis.cn для материкового Китая). Эта серия также использует https://api.toapis.com.
    • Общая аутентификация: один API-ключ в Authorization: Bearer. Отдельного публичного документа OAuth-scopes для этих видеовызовов нет.
    • Выбор клиента: OpenAI SDK с base_url="https://api.toapis.com/v1" удобен для чата и привычной связки ключа и origin. Для Grok Video это руководство использует документированное REST JSON-тело, чтобы явно сохранить video_generation_mode и поля URL изображений.

    2. Совместимый origin, список моделей и видеопути

    Держите origin, префикс /v1 и ключ вместе. Смешивать ключ ToAPIs с https://api.openai.com/v1 или origin ToAPIs с нативным путём поставщика Grok — это другая и недокументированная схема.

    ШагДокументированный путьПримечание
    Список моделейGET /v1/models?type=videoПо умолчанию GET /v1/models возвращает только текстовые модели. Используйте type=video или type=all
    Загрузка локального изображенияPOST /v1/uploads/images (multipart file)Читайте data.url. Не отправляйте base64 в вызове генерации
    Создание задания Grok VideoPOST /v1/videos/generationsТело включает model, prompt и поля режима/медиа для 1.5
    Опрос статусаGET /v1/videos/generations/{id}Конечные состояния — completed и failed
    Чат (не видео)POST /v1/chat/completionsСовместно используются только origin и ключ

    На grok-video-1.5 задайте video_generation_mode как text_to_video, first_frame_image_to_video или reference_images_to_video, чтобы JSON совпадал с отправляемыми медиа. Полевой контракт описан в практическом руководстве по Grok Video и в справочнике API Grok Video 1.5.

    Панель совместимого клиента соединяется через шестиугольный шлюз с путями отправки и опроса

    Рис. 1: Направьте клиент на origin ToAPIs /v1, найдите grok-video-1.5 или grok-video-1.0 в списке моделей, затем отправляйте и опрашивайте задания на /v1/videos/generations — не на chat/completions.

    Если вы настраиваете настольный клиент, а не код приложения, руководство по Chatbox описывает поле хоста для чата. Не ожидайте, что тот же чат-путь вернёт видеофайл.


    3. Продакшен-реализация: cURL и Python

    Международные примеры этой серии используют https://api.toapis.com. Официальная документация предписывает пользователям в материковом Китае https://toapis.cn. Оставляйте один origin на среду.

    Шаг 1: обнаружьте ID, затем отправьте задание через 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"
      }'
    

    Прежде чем жёстко прописывать ID, проверьте точную строку id в списке моделей. Если grok-video-3 отсутствует, не отправляйте его.

    Шаг 2: Python — общий origin и REST-вызовы видео

    OpenAI SDK показан только для общего base_url и API-ключа. Создание и опрос видео остаются на документированных путях generations, чтобы поля тела 1.5 не потерялись в неофициальном сопоставлении клиента.

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

    Если вызов списка вернул неожиданный конверт, сохраните сырой JSON и согласуйте разбор со страницей Список моделей для вашего аккаунта. Не изобретайте запасной путь, который отправляет grok-video-3, когда ID отсутствует.


    4. Обработка ошибок и матрица статусов

    Категории ниже — отправная точка диагностики, а не гарантия точных кодов ошибок ToAPIs. Успешный HTTP-запрос всё равно требует чтения status задачи. См. справочник ошибок.

    HTTP или состояние задачиТипичная категорияРекомендуемое действие
    400Неизвестный ID модели, несоответствие режима и медиа или видеотело, отправленное на чат-путьПодтвердите ID в GET /v1/models?type=video, что вы отправили POST на /v1/videos/generations, и что задания 1.5 содержат согласованный video_generation_mode
    401Отсутствует или недействителен API-ключИспользуйте ключ ToAPIs, а не ключ платформы OpenAI, и проверьте заголовок Bearer
    404Неверный origin, отсутствует /v1 или придуманный путь вроде /videos/tasks/{id}Перейдите на GET /v1/videos/generations/{id} на том origin, которым вы отправляли задание
    429Ограничение частоты или параллелизмаСоблюдайте Retry-After, если он есть; делайте паузу с джиттером
    5xx или таймаут клиентаВременный сбой шлюза или UpstreamЗапросите существующий id задачи до повторной отправки
    status: failedГенерация не удаласьПрочитайте error.code и error.message. Не повторяйте без изменений тело, отклонённое политикой

    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. Цены и 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

    • Совместимость не меняет биллинговый SKU. Счёт выставляется за каталожный ID, который вы отправили (grok-video-1.5 или grok-video-1.0), а не за «использование OpenAI SDK».
    • Не переиспользуйте удельные цены из черновиков планирования. Справочник Grok Video 1.5 не гарантирует фиксированную цену за секунду. Официальные справочные строки поставщика на странице цен ToAPIs носят ознакомительный характер и могут не совпадать с биллингом аккаунта.
    • Обнаружение моделей дёшево, повторная генерация — нет. Список моделей можно кратко кэшировать, но после таймаута клиента всегда проверяйте статус, прежде чем создавать ещё одно задание.
    • Биллинг ToAPIs обычно идёт по факту использования — подтвердите действующие условия в аккаунте.

    6. Часто задаваемые вопросы

    См. блок FAQ во frontmatter. Кратко: совместимый origin не открывает grok-video-3; /v1 добавляйте один раз; опрашивайте /v1/videos/generations/{id}; не предполагайте помощник SDK videos.create; chat completions не вернут MP4.


    7. Чек-лист действий

    • Создайте ключ на портале разработчика ToAPIs.
    • Направьте клиент на https://api.toapis.com/v1 (или https://toapis.cn/v1 в материковом Китае) с заголовком Authorization: Bearer.
    • Вызовите GET /v1/models?type=video и запишите точные ID Grok Video, видимые вашему ключу.
    • Проведите дымовой тест POST /v1/videos/generations с grok-video-1.5 и video_generation_mode: "text_to_video", затем опросите тот же id.
    • Далее: практическое руководство по Grok Video для режимов и полей изображений и model-guide Grok Video 1.5 для живого статуса каталога.

    Модели и API, упомянутые в статье

    xAIVIDEO

    grok-video-1.0

    Текущий тариф:2 credits /second
    Гид по моделиТестировать в консолиПолучить API ключ
    xAIVIDEO

    Grok Video 1.5

    Текущий тариф:3.824 credits /second
    Гид по моделиТестировать в консолиПолучить API ключ

    Похожие статьи

    tutorial2026-11-17T10:00:00+08:006 мин чтения

    Практическое руководство по Grok-Video-3 API: что нужно знать о текущем контракте видеодвижка xAI

    Практическое руководство по вызову xAI Grok Video на ToAPIs: в публичном каталоге указаны grok-video-1.0 и grok-video-1.5, а не grok-video-3; ниже — текущий контракт generations, режимы и путь опроса.

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    tutorial2026-11-20T10:00:00+08:008 мин чтения

    Alibaba Wan 3.0 Video API: старт работы с видеогенерацией нового поколения

    Производственный быстрый старт для wan3.0-video и wan3.0-video-prime на ToAPIs: один All-in-One эндпоинт, взаимное исключение первого и последнего кадров и опорных медиа, ссылки на файл или страницу, ограничения видеоредактирования и документированный путь опроса.

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    tutorial2026-11-18T10:00:00+08:007 мин чтения

    Kling 3.0 Turbo API: архитектура автоматизации массового короткого видео

    Продакшен-руководство по kling-3.0-turbo на ToAPIs: документированные диапазоны duration и разрешения, ввод только первого кадра, ограниченный цикл опроса и автоматизация коротких роликов без непроверенных цен из черновиков.

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Turbo
    ToAPIs
    ГлавнаяToAPIs
    Корпоративный шлюз AI API. Доступ к GPT-5, Claude, Gemini и 200+ моделям через единый API.

    Популярные модели

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Показать большеСвернуть
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Все модели

    Категории API

    • API генерации изображений
    • API генерации видео
    • API видео из текста
    • API видео из изображения
    Показать большеСвернуть
    • API редактирования изображений
    • Языковые модели и рассуждения
    • Все инструменты API →

    Альтернативы

    Альтернативы
    • Альтернатива Kie.ai
    • Альтернатива Fal.ai
    • Альтернатива OpenRouter
    • Альтернатива Replicate
    • Альтернатива Wavespeed AI
    • Все сравнения →

    Избранные руководства

    Избранные руководства
    • Цены Seedance 2.0 и 2.5
    • Недорогой API Seedance
    • Интеграция MiniMax H3
    • Бесплатный тестовый ключ Seedance 2
    • Быстрый старт Seedance 2 API
    • Все технические статьи →

    Разработчикам

    Разработчикам
    • Документация API
    • MCP
    • Цены
    • Тестирование моделей
    • LLMs.txt
    • Связаться с поддержкой
    • Каталог руководств по моделям
    Оператор:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Юридический адрес:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    КонфиденциальностьУсловияПолитика использованияУдаление данныхХранение данныхСубпроцессоры и регионыОплата и возвратПолитика CookieКарта сайтаО нас

    © 2026 ToAPIs. Все права защищены.