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: что нужно знать о текущем контракте видеодвижка xAI
    Назад ко всем статьям
    tutorial2026-11-176 мин чтения

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

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

    ToAPIs Engineering & Evaluation Team
    Grok VideoVideo APIxAIText-to-VideoTutorial
    TL;DR - Ключевые моменты
    • Снимок публичного каталога датирован 2026-11-10. Повторная проверка документации и страниц model-guide 2026-11-17 не выявила публичного идентификатора ToAPIs с именем grok-video-3. Документированные ID Grok Video — grok-video-1.0 и grok-video-1.5.
    • Отправляйте задания на POST /v1/videos/generations с ключом Bearer, сохраняйте id задачи и опрашивайте GET /v1/videos/generations/{id}. Не вызывайте недокументированный путь /videos/tasks.
    • Для grok-video-1.5 документированы три явных режима: text_to_video, first_frame_image_to_video и reference_images_to_video. Значение video_generation_mode должно совпадать с фактически отправляемыми медиа.
    • Изображения должны быть публичными URL http(s). Локальные файлы сначала загружайте через POST /v1/uploads/images; эти API генерации не принимают base64.
    • Не переиспользуйте непроверенные цены за секунду и цифры SLA из черновиков планирования. Перед прогнозом списка кадров подтвердите живой тариф и доступность канала в аккаунте.

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

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


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

    • Сначала каталог: даже практическая статья про Grok Video 3 должна начинаться с идентификаторов, которые ToAPIs действительно публикует. Снимок публичного производственного каталога от 2026-11-10 перечисляет grok-video-1.0 и grok-video-1.5 на эндпоинте openai-video. Проверка URL документации и model-guide для grok-video-3 2026-11-17 вернула HTTP 404.
    • Контракт: отправляйте задания асинхронно на POST /v1/videos/generations, затем опрашивайте GET /v1/videos/generations/{id} до completed или failed. Официальные примеры используют https://toapis.com (и https://toapis.cn для материкового Китая). Другие руководства этой серии используют https://api.toapis.com. Выберите один origin и придерживайтесь его.
    • Режимы: grok-video-1.5 документирует text_to_video, first_frame_image_to_video и reference_images_to_video. Явно задавайте video_generation_mode, чтобы одно референсное изображение не обрабатывалось как устаревшее first-frame задание.
    • Медиа: отправляйте только публичные URL http:// или https://. Локальные файлы загружайте через POST /v1/uploads/images и используйте возвращённый data.url. Не отправляйте base64.
    • Непроверенные утверждения, которые нужно отбросить: черновики планирования с ID grok-video-3, SLA 99,95%, фиксированной ценой $0.030–$0.038 за секунду или датой появления звука не являются текущей документацией ToAPIs. Живые тарифы и доступность канала подтверждайте в аккаунте.

    2. Текущие идентификаторы Grok Video и режимы генерации

    В поле model используйте публичное имя модели. Не подменяйте его именем поставщика, URL-slug или неопубликованной строкой grok-video-3.

    ID каталогаДокументированные задачиДлительность (документы)РазрешениеВходные изображения
    grok-video-1.5Текст, первый кадр или 1–7 референсов, выбирается через video_generation_modeЦелое число 1–15 секунд480p или 720p в режиме референсов; текст и first-frame могут использовать 1080p, если канал поддерживаетПервый кадр: ровно одно значение в image или input_reference. Режим референсов: 1–7 reference_images
    grok-video-1.0Text-to-video и image-to-videoСправочник генерации: 1–15 секунд (по умолчанию 8). Model-guide / Playground: потолок 6 секунд у доступного варианта480p, 720pНеобязательные image и reference_images; всего до 8 изображений

    Для новых интеграций grok-video-1.5 задавайте режим явно:

    video_generation_modeОбязательный вводЧто нельзя передавать
    text_to_videoНепустой promptЛюбые поля изображений
    first_frame_image_to_videoРовно один первый кадр в image или input_referenceПротиворечивые значения в обоих псевдонимах; не добавляйте список референсов, пока справочник вашего аккаунта не скажет иное
    reference_images_to_videoprompt плюс 1–7 reference_images (строки или объекты {"url":"..."})Одна запись reference_images без этого режима — устаревший одиночный ввод по-прежнему ведёт себя как first-frame

    Успешная котировка не гарантирует, что канал генерации открыт. Режимы доступны только после включения на совместимом канале; неподдерживаемые комбинации могут быть отклонены до создания задачи.

    Типичные значения соотношения сторон в справочниках Grok Video: 16:9, 9:16, 3:2, 2:3 и 1:1. Доступность зависит от канала, поэтому отправляйте значение, подтверждённое для этого ID.

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

    Рис. 1: Отправьте промпт (и при необходимости публичные URL изображений) на POST /v1/videos/generations, опрашивайте тот же id задачи и читайте result.data[0].url только после status completed.

    Если нужны возможности официального канала Grok Imagine, например продление видео, это другое семейство ID — см. руководство по официальному каналу Imagine. Для второго видеоконтракта с другой матрицей длительности см. руководство по Hailuo 2.3.


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

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

    Шаг 1: отправка grok-video-1.5 через cURL

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

    Задание с первым кадром использует тот же путь с "video_generation_mode": "first_frame_image_to_video" и URL в image. Задание с референсами задаёт "video_generation_mode": "reference_images_to_video" и список reference_images, оставляя resolution равным 480p или 720p.

    Шаг 2: помощник на Python для отправки и опроса

    Фрагмент следует документированному пути статуса и состояниям queued / in_progress / completed / failed. Перед выпуском сверьте id, result.data[0].url и конверт ответа со справочником API вашего аккаунта.

    python
    import os
    import time
    import requests
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    ENDPOINT = f"{BASE}/v1/videos/generations"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    
    def dispatch_grok_video(
        prompt: str,
        *,
        model: str = "grok-video-1.5",
        mode: str = "text_to_video",
        duration: int = 8,
        resolution: str = "720p",
        aspect_ratio: str = "16:9",
        image_url: str | None = None,
        reference_images: list[str] | None = None,
    ) -> str:
        if model == "grok-video-3":
            raise ValueError("grok-video-3 is not a current public catalog ID")
        if mode == "reference_images_to_video" and resolution not in {"480p", "720p"}:
            raise ValueError("reference mode is documented as 480p or 720p")
        payload = {
            "model": model,
            "prompt": prompt,
            "duration": duration,
            "resolution": resolution,
            "aspect_ratio": aspect_ratio,
        }
        if model == "grok-video-1.5":
            payload["video_generation_mode"] = mode
        if mode == "text_to_video" and (image_url or reference_images):
            raise ValueError("text_to_video rejects image fields")
        if mode == "first_frame_image_to_video":
            if not image_url:
                raise ValueError("first-frame mode requires exactly one image URL")
            payload["image"] = image_url
        if mode == "reference_images_to_video":
            refs = reference_images or []
            if not (1 <= len(refs) <= 7):
                raise ValueError("reference mode requires 1-7 image URLs")
            payload["reference_images"] = refs
        res = requests.post(ENDPOINT, 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) -> 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__":
        task_id = dispatch_grok_video(
            "A cinematic product shot with a slow camera push-in",
            mode="text_to_video",
            duration=8,
            resolution="720p",
        )
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    Храните версию шаблона промпта рядом с записью задачи, чтобы отличать смену модели или режима от правки формулировки. Скачайте файл до expires_at; справочник статуса документирует окно хранения 30 дней.


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

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

    HTTP или состояние задачиТипичная категорияРекомендуемое действие
    400Недопустимое поле, несоответствие режима и медиа или неподдерживаемая комбинацияПроверьте точный ID каталога, что video_generation_mode совпадает с полями изображений, что режим референсов остаётся на 480p или 720p, и что значения изображений — публичные URL
    401Отсутствует или недействителен API-ключОбновите ключ в панели ToAPIs и проверьте заголовок Authorization: Bearer
    429Ограничение частоты или параллелизмаСоблюдайте Retry-After, если он есть; делайте паузу с джиттером; повторяйте только когда это безопасно
    5xx или таймаут клиентаВременный сбой шлюза или UpstreamЗапросите существующий id задачи до повторной отправки
    status: queued или in_progressЭто не ошибкаПодождите и опросите снова; не создавайте вторую задачу
    status: failedГенерация не удаласьПрочитайте error.code и error.message (и error.reason, если есть). Не повторяйте без изменений тело, отклонённое политикой

    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

    • Не переиспользуйте удельные цены из черновиков планирования. Справочник API grok-video-1.5 указывает, что тарификация следует текущей конфигурации аккаунта и SKU и что страница не гарантирует фиксированную цену за секунду. Официальные справочные строки поставщика на странице цен ToAPIs носят ознакомительный характер и могут не совпадать с фактическим биллингом аккаунта.
    • Котировка не гарантирует канал. Справочник 1.5 отмечает, что успешная котировка не означает доступность канала генерации.
    • Контролируйте расходы на уровне промпта: делайте черновики в 720p и средней длительности около 8 секунд, храните версионированный шаблон, меняйте по одной переменной и не переотправляйте после таймаута клиента, пока не проверите статус задачи.
    • Официальные контракты поставщиков часто добавляют годовые обязательства, квоты мест и предоплату. Биллинг ToAPIs обычно идёт по факту использования — подтвердите действующие условия в аккаунте.

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

    См. блок FAQ во frontmatter. Кратко: grok-video-3 не является текущим публичным ID каталога; начинайте с grok-video-1.5 или grok-video-1.0; потолок длительности 1.0 считайте канальной проверкой; синхронное аудио не документировано; всегда опрашивайте путь статуса generations и сохраняйте id задачи.


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

    • Создайте ключ на портале разработчика ToAPIs.
    • Убедитесь, что grok-video-1.5 или grok-video-1.0 видны вашему ключу через GET /v1/models?type=video — не отправляйте grok-video-3, пока этот ID не появится и в списке, и в справочнике API.
    • Проведите дымовой тест cURL с video_generation_mode: "text_to_video", duration: 8 и resolution: "720p".
    • Опрашивайте GET /v1/videos/generations/{id} с ограниченным дедлайном и скачайте результат до expires_at.
    • Далее: руководство по OpenAI-совместимому доступу, если настраиваете существующий клиент; model-guide Grok Video 1.5 для живого статуса каталога; model-guide Grok Video 1.0 перед тем, как опираться на длительность больше 6 секунд на этом ID.

    Модели и 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:005 мин чтения

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

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

    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 Omni API: многокадровая генерация видео и физическая согласованность

    Практическое руководство по kling-v3-omni на ToAPIs: официальные плейсхолдеры Omni, image_list, video_list и element_list, первый и конечный кадры и документированный путь опроса — без недокументированного массива shots.

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Omni
    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. Все права защищены.