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 Imagine 1.0 Video Generation API: эндпоинты, области авторизации и обработка ошибок
    Назад ко всем статьям
    tutorial2026-11-176 мин чтения

    Grok Imagine 1.0 Video Generation API: эндпоинты, области авторизации и обработка ошибок

    Текущий контракт ToAPIs для Grok Imagine использует grok-imagine-video-official и grok-imagine-video-1.5-official: аутентификация Bearer API-ключом, эндпоинты generations и extend, а также документированная обработка ошибок и статусов — без ID grok-imagine-1.0 и без матрицы OAuth-scopes.

    ToAPIs Engineering & Evaluation Team
    Grok ImagineVideo APIAuthenticationError HandlingTutorial
    TL;DR - Ключевые моменты
    • Публичного каталожного ID с именем grok-imagine-1.0 нет. Документированные ID официального канала — grok-imagine-video-official (текст, изображение и несколько референсов плюс продление) и grok-imagine-video-1.5-official (только image-to-video с первого кадра, до 1080p, без продления).
    • Документированная аутентификация — API-ключ Bearer в заголовке Authorization. Публичной матрицы OAuth-scopes (например videos:write) для этих эндпоинтов найти не удалось.
    • Создавайте задания через POST /v1/videos/generations и опрашивайте GET /v1/videos/generations/{id}. Продлевайте клипы официального канала через POST /v1/videos/{video_id}/extend или POST /v1/videos/extend плюс video_urls на 2–10 дополнительных секунд.
    • Локальные изображения загружайте через POST /v1/uploads/images и отправляйте только публичные URL. official допускает до 7 изображений в сумме image и reference_images; 1.5-official требует ровно один первый кадр и не документирует продление видео.
    • Выход тарифицируется посекундно по уровню разрешения; входные изображения — за штуку; продление также тарифицирует длительность исходного видео. Подтверждайте живые тарифы в аккаунте и не переиспользуйте цены из черновиков.

    Grok Imagine 1.0 Video Generation API: эндпоинты, области авторизации и обработка ошибок

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


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

    • Идентификаторы: запросы под заголовком «Grok Imagine 1.0» должны использовать строки, которые ToAPIs действительно публикует. Снимок публичного каталога от 2026-11-10 перечисляет grok-imagine-video-official и grok-imagine-video-1.5-official (оба также появляются в image-generation и в openai-video). Проверка пути документации grok-imagine-1.0 2026-11-17 вернула HTTP 404.
    • Аутентификация: отправляйте Authorization: Bearer $TOAPIS_API_KEY. Официальные страницы не документируют OAuth-scopes, гранулярные имена прав или эндпоинт обнаружения scopes для этих вызовов.
    • Эндпоинты: создание — POST /v1/videos/generations. Опрос — GET /v1/videos/generations/{id}. Продление вывода официального канала — POST /v1/videos/{video_id}/extend либо POST /v1/videos/extend с video_urls, если есть только публичный URL видео. Загрузка кадров — POST /v1/uploads/images.
    • Возможности: grok-imagine-video-official закрывает text-to-video, image-to-video и несколько референсов при 480p или 720p, длительности 1–15 секунд и продлении на 2–10 секунд. grok-imagine-video-1.5-official — только image-to-video с первого кадра, требует ровно одно image, допускает 1080p и не поддерживает продление.
    • Форма тарификации (фиксированной публичной цены на страницах справочника нет): выход — посекундно по уровню разрешения; каждое входное изображение — за штуку; продление также тарифицирует длительность исходного видео. Подтверждайте живые тарифы аккаунта.

    2. Эндпоинты, аутентификация и контракты моделей

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

    ДействиеМетод и путьЗаметки по модели
    Загрузка кадраPOST /v1/uploads/imagesMultipart file. JPEG, PNG, WebP или GIF, максимум 30 МБ. Читайте data.url
    Создание видеоPOST /v1/videos/generationsОба официальных ID Imagine
    Запрос статусаGET /v1/videos/generations/{id}Один путь для задач генерации и продления
    Продление из предыдущей задачиPOST /v1/videos/{video_id}/extendТолько grok-imagine-video-official. video_id — id предыдущей задачи генерации
    Продление из публичного URLPOST /v1/videos/extendТот же официальный ID; video_urls обязателен, если в пути нет id
    ID каталогаДокументированные задачиДлительностьРазрешениеИзображенияПродление
    grok-imagine-video-officialText-to-video, первый кадр и несколько референсов1–15 секунд (по умолчанию 8)480p, 720pНеобязательные image и reference_images; всего до 72–10 секунд (duration по умолчанию 6)
    grok-imagine-video-1.5-officialТолько image-to-video с первого кадра1–15 секунд (по умолчанию 8)480p, 720p, 1080pimage обязателен (ровно один первый кадр). Дополнительные reference_images тоже входят в лимит 7Не поддерживается

    Значения соотношения сторон в официальных справочниках Imagine включают 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 и 1:1. Отправляйте значение, подтверждённое для этого ID и канала.

    Публичной строки scope, которой отдельно запрашивают «генерацию», «продление» или «загрузку», нет. Доступ определяется тем, что уже разрешают API-ключ, группа пользователей и конфигурация канала. Если вызов завершился ошибкой прав или доступности, проверяйте список моделей ключа и справочник ошибок, а не добавляйте выдуманный параметр scope.

    Узел учётных данных проходит через шестиугольный шлюз к трём плиткам эндпоинтов

    Рис. 1: Один API-ключ Bearer уполномочивает загрузку, генерацию или продление и опрос статуса; официальный ID 1.5 не добавляет ветку продления.

    Неофициальное семейство Grok Video (grok-video-1.0 / grok-video-1.5) описано в практическом руководстве по Grok Video. Эти ID — другой контракт и не наследуют этот путь продления.


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

    Шаг 1: cURL — text-to-video официального канала

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

    Задание с первым кадром на grok-imagine-video-1.5-official использует тот же путь, требует "image": "https://example.com/portrait.jpg" и может задавать "resolution": "1080p". Замените пример URL на доступный публичный адрес — если файл локальный, сначала загрузите его:

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

    Шаг 2: Python — генерация, опрос и необязательное продление

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

    Чтобы продлить публичный MP4, а не задачу по id, отправьте на POST /v1/videos/extend ту же официальную модель, промпт, duration и список video_urls. Не вызывайте продление с grok-imagine-video-1.5-official.


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

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

    HTTP или состояние задачиТипичная категорияРекомендуемое действие
    400Недопустимое поле, отсутствует обязательный image на 1.5-official, превышен лимит изображений или продление отправлено модели, которая его не поддерживаетПроверьте точный официальный ID, длительность (1–15 при генерации, 2–10 при продлении), разрешение (1080p только на 1.5-official) и что все медиа — публичные URL
    401Отсутствует или недействителен API-ключОбновите ключ и проверьте Authorization: Bearer. Не добавляйте недокументированный параметр scope как обходной путь
    429Ограничение частоты или параллелизмаСоблюдайте Retry-After, если он есть; делайте паузу с джиттером
    5xx или таймаут клиентаВременный сбой шлюза или UpstreamЗапросите существующий id задачи до повторной отправки
    status: queued или in_progressЭто не ошибкаПодождите и опросите снова
    status: failed с content_policy_rejectedПроверка безопасности или авторских правПроверьте промпт и каждый референс; корректный ввод всё равно может дать отклонённый вывод
    status: failed с insufficient_user_balance или token_quota_exceededБаланс или лимит токеновПроверьте и баланс, и периодические лимиты
    status: failed с generation_timeout, model_unavailable или service_busyТаймаут или доступность UpstreamСначала проверьте существующий id; повторяйте с паузой только если задача уже конечная

    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

    Страницы официальной генерации и продления Imagine описывают форму тарификации, а не фиксированную публичную удельную цену:

    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)

    Используйте тарифы, возвращённые для вашего аккаунта и SKU, а не числа из черновиков.

    • grok-imagine-video-1.5-official всегда включает одну плату за входное изображение, потому что первый кадр обязателен.
    • Продление — не бесплатное продолжение. Официальный биллинг продления включает сгенерированные секунды продления и длительность исходного видео. Цепочка продлений поэтому снова тарифицирует растущую длину источника — подтвердите это поведение живой котировкой, прежде чем строить цикл.
    • Не переиспользуйте удельные цены и цифры SLA из черновиков планирования. Официальные справочные строки поставщика на странице цен ToAPIs носят ознакомительный характер и могут не совпадать с биллингом аккаунта.
    • Делайте черновики в 720p и средней длительности, меняйте по одной переменной и не переотправляйте после таймаута клиента, пока не проверите статус задачи.

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

    См. блок FAQ во frontmatter. Кратко: отправляйте grok-imagine-video-official или grok-imagine-video-1.5-official, а не grok-imagine-1.0; аутентификация — API-ключ Bearer без публичной матрицы OAuth-scopes; 1.5-official — только first-frame и без продления; длительность продления 2–10 секунд и тарифицирует длину источника; всегда различайте HTTP-ошибки и status: failed.


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

    • Создайте ключ на портале разработчика ToAPIs.
    • Убедитесь, что grok-imagine-video-official или grok-imagine-video-1.5-official видны вашему ключу через GET /v1/models?type=video.
    • Проведите дымовой тест генерации официального канала в 720p, опросите GET /v1/videos/generations/{id} и скачайте файл до expires_at.
    • Если нужно продолжение, продлевайте только с grok-imagine-video-official и duration 2–10 секунд, затем подтвердите, что котировка включает тарификацию длительности источника.
    • Далее: официальный model-guide Imagine и официальный model-guide Imagine 1.5 для живого статуса каталога и практическое руководство по Grok Video, если имелось в виду неофициальное семейство grok-video-*.

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

    xAIVIDEO

    grok-imagine-video-official

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

    grok-imagine-video-1.5-official

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

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

    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
    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. Все права защищены.