Grok Imagine Image

grok-imagine-image Генерируйте изображения по текстовым запросам с помощью моделей Grok Imagine. API поддерживает пакетную генерацию нескольких изображений, а также управление соотношением сторон и разрешением.

Эндпоинты

POST /v1/queue/grok-imagine-image # Создать задачу

GET /v1/queue/grok-imagine-image/requests/{request_id}/status # Проверить статус

GET /v1/queue/grok-imagine-image/requests/{request_id}/response # Получить результат

PUT /v1/queue/grok-imagine-image/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --location "https://api.odirouter.ai/model/v1/queue/grok-imagine-image" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A cinematic portrait of a glass robot in a sunlit studio.",
    "image": {
      "url": "https://example.com/reference.png"
    },
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "response_format": "url"
  }'

prompt string required

Промпт для генерации изображения.

image null | object

Входное изображение для запросов генерации и редактирования. Взаимоисключается с images.

Принимает публичный URL или Base64-кодированный data URL.

Поддерживаемые форматы изображений: JPEG, PNG, WebP.

Для совместимости также поддерживается поле image_url.

url string required

Публичный URL или Base64-кодированный data URL изображения.

Обязательно при передаче image.

images array

Список входных изображений для редактирования с несколькими референсами. Взаимоисключается с image.

Если передано несколько изображений, ссылайтесь на них в prompt как <IMAGE_0>, <IMAGE_1> и т. д.

Каждый объект изображения принимает публичный URL или Base64-кодированный data URL. Поддерживаемые форматы: JPEG, PNG, WebP.

url string required

Публичный URL или Base64-кодированный data URL изображения.

Обязательно для каждого объекта изображения.

n integer | null

Количество изображений для генерации.

По умолчанию: 1.

Минимум: 1.

Максимум: 10.

aspect_ratio null | string

Соотношение сторон для генерации изображения.

Возможные значения: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto.

resolution null | string

Разрешение для генерации изображения.

Возможные значения: 1k, 2k.

response_format string | null

Формат ответа для возвращаемого изображения.

По умолчанию: url.

Возможные значения: url, b64_json.

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

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/grok-imagine-image/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/grok-imagine-image/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/grok-imagine-image/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции