GPT Image 2.5 API
Эндпоинты и аутентификация
Relay использует формат, совместимый с OpenAI Images API:
- Генерация изображений:
POST https://relay-llm.ru/v1/images/generations - Редактирование изображений:
POST https://relay-llm.ru/v1/images/edits
Заголовки запроса:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Эндпоинт редактирования также принимает multipart/form-data для загрузки файлов изображений.
Генерация изображений
Минимальный запрос:
curl https://relay-llm.ru/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2-5",
"prompt": "An orange tabby cat typing on a keyboard, illustration style"
}'
Укажите размер и качество:
{
"model": "gpt-image-2-5",
"prompt": "An orange tabby cat typing on a keyboard, illustration style",
"size": "2048x2048",
"quality": "high"
}
Основные параметры:
| Параметр | Описание |
|---|---|
model | Используйте gpt-image-2-5. Модель нужно указывать явно: если model не задан, по умолчанию используется gpt-image-2-5. |
prompt | Описание изображения, которое нужно сгенерировать. |
size | auto или ширинаxвысота, например 1024x1024, 2048x2048, 3840x2160. |
quality | low, medium, high или auto. |
n | Число изображений за запрос. По умолчанию 1. |
output_format | png, jpeg или webp. |
output_compression | Уровень сжатия JPEG/WebP, от 0 до 100. |
background | transparent, opaque или auto. При transparent возвращаемое изображение содержит альфа-канал; сочетайте с output_format png или webp. |
moderation | Строгость модерации контента, low или auto. |
stream | true , ответ приходит потоком по SSE: у промежуточных фрагментов потока (чанков) object равен image.generation.chunk, у финального , image.generation.result с изображением в data[0].b64_json, затем data: [DONE]. |
partial_images | От 0 до 3. Сейчас промежуточные фрагменты не содержат изображения; результат только в финальном фрагменте. |
user | Идентификатор конечного пользователя в вашем приложении, передаётся как есть. |
Ограничения OpenAI на размер для gpt-image-2-5: длинная сторона не более 3840 пикселей; ширина и высота кратны 16; соотношение сторон не более 3:1; общее число пикселей от 655 360 до 8 294 400. Размеры задаются в пикселях, а не фиксированными строками 1k, 2k, 4k.
Редактирование изображений
curl https://relay-llm.ru/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=gpt-image-2-5" \
-F "prompt=Replace the background with snowy mountains" \
-F "image=@input.png" \
-F "size=1024x1024"
Основные параметры:
| Параметр | Описание |
|---|---|
model | Используйте gpt-image-2-5. |
image | Файл исходного изображения. |
mask | Файл маски; прозрачные области редактируются. Размеры маски должны совпадать с размерами исходного изображения. |
prompt | Инструкция по редактированию. |
n | Число изображений за запрос. По умолчанию 1. |
size | auto или ширинаxвысота. |
quality | low, medium, high или auto. |
background | transparent, opaque или auto. По результатам тестов изображения из эндпоинта редактирования не содержат альфа-канала. |
input_fidelity | Насколько точно сохранять детали исходного изображения, high или low. |
output_format | png, jpeg или webp. |
output_compression | Уровень сжатия JPEG/WebP, от 0 до 100. |
stream | true , ответ приходит потоком по SSE. Формат событий такой же, как при генерации изображений. |
partial_images | От 0 до 3. |
user | Идентификатор конечного пользователя в вашем приложении, передаётся как есть. |
Размеры и правила тарификации
Параметры и единица цены зависят от модели. Ниже приведены первые три строки её активного прайса.
| Параметры модели | Цена |
|---|---|
| resolution: 1K | 0.1 USD / запрос |
| resolution: 2K | 0.17 USD / запрос |
| resolution: 4K | 0.26 USD / запрос |
Параметры и цены берутся из каталога модели. Если size равен auto, не указан или пуст, тарификация идёт по размеру, который реально выдала модель; без size модель по умолчанию выдаёт 1024 или 1254 пикселя, что тарифицируется как 1K или 2K соответственно. Если нужна фиксированная ступень, укажите size явно. Цены трёх ступеней смотрите в разделе актуальные цены.
FAQ
Codex сообщает, что сервис генерации изображений недоступен или не удаётся подключиться?
С разрешениями по умолчанию Codex ограничивает доступ к сети, и запрос на генерацию изображения блокируется. Включите полный доступ (Full access) и повторите генерацию.
Нажмите кнопку разрешений в левом нижнем углу поля ввода Codex и выберите полный доступ.

Если в этом меню нет пункта полного доступа, нажмите значок шестерёнки в левом нижнем углу окна, откройте «Настройки → Основные → Разрешения» (Settings → General → Permissions), включите полный доступ, а затем выберите его в поле ввода, как описано выше.

В режиме полного доступа Codex не спрашивает подтверждения, прежде чем изменять файлы на компьютере или запускать команды с доступом к сети.
Пополнение баланса
Способы оплаты, валюта и минимальная сумма показаны в форме пополнения баланса Relay.Пополнение баланса.