88API88API
Руководство пользователяAI-приложенияAPIПомощь и поддержка
Изображения (Image)

API моделей изображений Grok

Интерфейсы генерации по тексту и редактирования, соотношения сторон, разрешения, референсы и ошибки для моделей изображений Grok Imagine (grok-imagine-image, 2.0, quality, edit).

Область применения

На этой странице описаны модели изображений Grok Imagine. О видеомоделях см. Grok Video API.

Выбор интерфейса

Модели изображений Grok используют интерфейс, совместимый с OpenAI Images:

НазначениеМетод запросаКонечная точка
Генерация по текстуPOST/v1/images/generations
Редактирование изображения (генерация по изображению)POST/v1/images/edits

/v1/chat/completions и /v1/responses не поддерживаются. Референсы передаются только через /v1/images/edits; в /v1/images/generations они игнорируются.

Модели и возможности

МодельРазрешениеРеференсыИзображений за запросОплата
grok-imagine-image1K (по умолчанию) / 2K
aspect_ratio + resolution
до 3 (data URI / публичный URL / локальный файл)до 10за изображение
grok-imagine-image-2.01K (по умолчанию) / 2K
aspect_ratio + resolution
до 3 (data URI / публичный URL / локальный файл)до 10за изображение
grok-imagine-image-quality1K (по умолчанию) / 2K
aspect_ratio + resolution
до 3 (data URI / публичный URL / локальный файл)до 10за изображение
grok-imagine-edit
То же, что grok-imagine-image-quality
1K (по умолчанию) / 2K
aspect_ratio + resolution
до 3 (data URI / публичный URL / локальный файл)до 10за изображение

Поддерживаемые соотношения сторон: auto (по умолчанию) / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 2:1 / 1:2 / 19.5:9 / 9:19.5 / 20:9 / 9:20 / 21:9 / 5:2

Модельqualityresponse_format
grok-imagine-imageНе поддерживаетсяb64_json / url
grok-imagine-image-2.0low / medium / autob64_json / url
grok-imagine-image-qualityНе поддерживаетсяb64_json / url
grok-imagine-editНе поддерживаетсяb64_json / url
  • Все четыре модели умеют и генерировать изображения по тексту, и редактировать изображения.
  • grok-imagine-edit и grok-imagine-image-quality — одна и та же модель, результат у них одинаковый.
  • Параметр quality действует только для grok-imagine-image-2.0.
  • Тарификация по числу успешно возвращённых изображений, независимо от разрешения и количества референсов.

Фактически доступные модели определяются списком моделей в консоли.

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

Authorization: Bearer $API_KEY
Content-Type: application/json

Соотношение сторон и разрешение

  • aspect_ratio: см. таблицу возможностей выше. По умолчанию auto — модель выбирает формат кадра по промпту, и для одного и того же промпта соотношение может меняться от запроса к запросу; если нужен фиксированный размер, передайте его явно.
  • resolution: 1k (по умолчанию) или 2k; 4K не поддерживается.

Выходные размеры в пикселях для каждого уровня (одинаковы для всех четырёх моделей):

Соотношение1K2K
1:11024x10242048x2048
16:91280x7202816x1584
9:16720x12801584x2816
4:31152x8642368x1776
3:4864x11521776x2368
3:21248x8322496x1664
2:3832x12481664x2496
2:11408x7042912x1456
1:2704x14081456x2912
19.5:91248x5762912x1344
9:19.5576x12481344x2912
20:91280x5763200x1440
9:20576x12801440x3200
21:91568x6723136x1344
5:21600x6403200x1280
  • При 1K результат выдаётся в JPEG, при 2K — в PNG; изменить это через output_format нельзя.
  • Можно использовать и привычный для OpenAI size (например, 1024x1024) — он пересчитывается автоматически: если длинная сторона не больше 1024, используется 1k, иначе 2k; соотношение сторон берётся ближайшее из поддерживаемых, поэтому итоговый размер в пикселях может не совпадать с запрошенным size. И 1536x1024, и 1792x1024 выдаются как 2k.
  • Если переданы одновременно size и aspect_ratio / resolution, приоритет у aspect_ratio / resolution.

Генерация по тексту

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "Улица Токио в дождливую ночь под неоновыми огнями, кинематографично, реалистичная фотография",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1
  }'

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

ПараметрТипОбязательноОписание
modelstringДаНазвание модели.
promptstringДаОписание изображения, не может быть пустым. Рекомендуется укладываться в несколько тысяч символов.
aspect_ratiostringНетСоотношение сторон, по умолчанию auto.
resolutionstringНет1k (по умолчанию) или 2k.
nintegerНетКоличество изображений, от 1 до 10, по умолчанию 1.
response_formatstringНетb64_json (по умолчанию) или url. При url возвращается ссылка на изображение на 88API.
qualitystringНетТолько grok-imagine-image-2.0: low, medium, auto (по умолчанию; при генерации соответствует low, при редактировании — medium). С medium генерация идёт медленнее.

Параметры style, seed, negative_prompt, background, output_format, stream и подобные игнорируются.

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

{
  "created": 1760000000,
  "data": [
    { "b64_json": "/9j/4AAQ...", "mime_type": "image/jpeg" }
  ]
}

В ответе нет revised_prompt.

Редактирование изображений

Запрос JSON (рекомендуется, поддерживает несколько референсов)

Для одного референса используйте image, для нескольких — массив images, не более 3 изображений:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "Перенеси человека с первого изображения в сцену со второго изображения, внешность человека не менять",
    "images": [
      "data:image/png;base64,...",
      "https://example.com/scene.jpg"
    ],
    "resolution": "2k"
  }'
  • Референсом может быть Data URI или публичный URL, доступный для прямого скачивания. Base64 должен содержать префикс data:image/...;base64,.
  • Поддерживаются JPG, PNG, WebP; GIF и BMP не поддерживаются.
  • Не передавайте image в виде массива и не передавайте image и images одновременно.
  • Референсы нумеруются в порядке передачи, в промпте на них можно ссылаться как на «первое изображение», «второе изображение».
  • Если соотношение сторон не указано, результат повторяет соотношение первого референса, разрешение по умолчанию — 1k; их можно переопределить через aspect_ratio и resolution.

Загрузка multipart (одно изображение)

Локальный файл можно загрузить и через multipart, но только по одному за раз, размер файла — не более 20 МБ:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=grok-imagine-image" \
  -F "image=@input.png" \
  -F "prompt=Заменить фон на закат у моря" \
  -F "aspect_ratio=1:1"

Если нужно несколько референсов, используйте запрос JSON.

Ограничения

  • Локальная перерисовка по mask не поддерживается, переданная маска игнорируется.
  • Потоковый вывод и асинхронное получение результата не поддерживаются.
  • Выходные изображения содержат учётные данные контента C2PA (с пометкой о генерации ИИ), видимого водяного знака нет.

Частые ошибки

СитуацияHTTPВозвращаемое сообщение
Вызов интерфейса чата или Responses400<模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits (модель предназначена для генерации изображений и не поддерживает этот интерфейс)
Неподдерживаемое соотношение сторон400不支持的图片比例。支持:… (неподдерживаемое соотношение сторон, далее список поддерживаемых)
Неподдерживаемое разрешение (например, 4k)400不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 (resolution поддерживает только 1k или 2k в нижнем регистре)
n вне диапазона 1–10, пустой prompt, одновременно переданы image и images, несколько изображений в multipart400上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 (вышестоящий сервис отклонил параметры запроса — проверьте название модели, интерфейс и параметры)
Неподдерживаемый формат референса, у Base64 нет префикса, URL не удаётся скачать400Сообщение об ошибке, связанной с референсом
Больше 3 референсов502Upstream request failed
Модерация контента не пройдена400图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 (генерация не прошла проверку безопасности контента — измените промпт или референсы и повторите попытку)

За перечисленные неудачные запросы плата не взимается.