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-image | 1K (по умолчанию) / 2Kaspect_ratio + resolution | до 3 (data URI / публичный URL / локальный файл) | до 10 | за изображение |
grok-imagine-image-2.0 | 1K (по умолчанию) / 2Kaspect_ratio + resolution | до 3 (data URI / публичный URL / локальный файл) | до 10 | за изображение |
grok-imagine-image-quality | 1K (по умолчанию) / 2Kaspect_ratio + resolution | до 3 (data URI / публичный URL / локальный файл) | до 10 | за изображение |
grok-imagine-editТо же, что grok-imagine-image-quality | 1K (по умолчанию) / 2Kaspect_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
| Модель | quality | response_format |
|---|---|---|
grok-imagine-image | Не поддерживается | b64_json / url |
grok-imagine-image-2.0 | low / medium / auto | b64_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 не поддерживается.
Выходные размеры в пикселях для каждого уровня (одинаковы для всех четырёх моделей):
| Соотношение | 1K | 2K |
|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 |
| 16:9 | 1280x720 | 2816x1584 |
| 9:16 | 720x1280 | 1584x2816 |
| 4:3 | 1152x864 | 2368x1776 |
| 3:4 | 864x1152 | 1776x2368 |
| 3:2 | 1248x832 | 2496x1664 |
| 2:3 | 832x1248 | 1664x2496 |
| 2:1 | 1408x704 | 2912x1456 |
| 1:2 | 704x1408 | 1456x2912 |
| 19.5:9 | 1248x576 | 2912x1344 |
| 9:19.5 | 576x1248 | 1344x2912 |
| 20:9 | 1280x576 | 3200x1440 |
| 9:20 | 576x1280 | 1440x3200 |
| 21:9 | 1568x672 | 3136x1344 |
| 5:2 | 1600x640 | 3200x1280 |
- При 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
}'Параметры запроса
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
model | string | Да | Название модели. |
prompt | string | Да | Описание изображения, не может быть пустым. Рекомендуется укладываться в несколько тысяч символов. |
aspect_ratio | string | Нет | Соотношение сторон, по умолчанию auto. |
resolution | string | Нет | 1k (по умолчанию) или 2k. |
n | integer | Нет | Количество изображений, от 1 до 10, по умолчанию 1. |
response_format | string | Нет | b64_json (по умолчанию) или url. При url возвращается ссылка на изображение на 88API. |
quality | string | Нет | Только 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 | Возвращаемое сообщение |
|---|---|---|
| Вызов интерфейса чата или Responses | 400 | <模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits (модель предназначена для генерации изображений и не поддерживает этот интерфейс) |
| Неподдерживаемое соотношение сторон | 400 | 不支持的图片比例。支持:… (неподдерживаемое соотношение сторон, далее список поддерживаемых) |
Неподдерживаемое разрешение (например, 4k) | 400 | 不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 (resolution поддерживает только 1k или 2k в нижнем регистре) |
n вне диапазона 1–10, пустой prompt, одновременно переданы image и images, несколько изображений в multipart | 400 | 上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 (вышестоящий сервис отклонил параметры запроса — проверьте название модели, интерфейс и параметры) |
| Неподдерживаемый формат референса, у Base64 нет префикса, URL не удаётся скачать | 400 | Сообщение об ошибке, связанной с референсом |
| Больше 3 референсов | 502 | Upstream request failed |
| Модерация контента не пройдена | 400 | 图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 (генерация не прошла проверку безопасности контента — измените промпт или референсы и повторите попытку) |
За перечисленные неудачные запросы плата не взимается.