Генерация Grok 5 Imagine

Документация API

Используйте эти конечные точки для отправки заданий Grok 5 Imagine и проверки их статуса. Каждый вызов расходует кредиты в зависимости от используемой модели.

Аутентификация

Все запросы должны включать ваш ключ API внутри Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Отсутствующие или недействительные ключи возвращают 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

Создание задачи генерации

Отправляет новое задание Grok 5 Imagine. Вызов немедленно возвращает task_id, в то время как рендеринг завершается асинхронно.

Параметр	Тип	Обязательный	Описание
model	string	Нет	Используемая модель: grok-imagine/text-to-image (по умолчанию), text-to-video, image-to-video или upscale.
input	object	Да	Объект входных параметров, содержащий prompt, image_urls или task_id в зависимости от модели.
input.prompt	string (max 5000 chars)	Нет	Текстовый запрос, описывающий, что нужно сгенерировать (обязательно для text-to-image и text-to-video).
input.image_urls	string[]	Нет	Массив URL-адресов изображений (обязательно для image-to-video).
input.task_id	string	Нет	ID предыдущей задачи для upscale или генерации image-to-video.
callback_url	string	Нет	URL вебхука для получения уведомлений о завершении задачи.
public	boolean	Нет	Сделать задачу доступной для публичных галерей.

Потребление кредитов

Кредиты списываются при создании задачи. Сбойные задания автоматически возвращаются (происходит возврат средств).

Модель	Списано кредитов
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

Пример запроса

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

Пример ответа

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

Проверка статуса задачи

Используйте эту конечную точку для опроса последней записи. Когда задача все еще находится в статусе IN_PROGRESS, мы запрашиваем провайдера еще раз перед ответом.

Параметр	Тип	Обязательный	Описание
task_id	string	Да	ID, возвращенный /generate. Отправляется через запрос (?task_id=) или тело JSON.

Поле	Описание
task_id	ID, возвращенный /generate.
status	SUCCESS (УСПЕХ)
request	Очищенная копия отправленной полезной нагрузки.
response	Объект, содержащий массив resultUrls, когда status - SUCCESS.
consumed_credits	Кредиты, списанные за задачу (0 при возврате средств).
error_message	Ошибка провайдера, когда status - FAILED.
created_at	Метка времени UTC, когда задание было сохранено.

Пример запроса

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

Пример ответа

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Обработка ошибок

401 Unauthorized - Отсутствует или недействителен ключ API.
402 Payment Required - Кредитный баланс не смог покрыть списание.
429 Too Many Requests - Уменьшите частоту опроса или скорость запросов.
500 - Временная проблема; повторите попытку с экспоненциальной задержкой.