Настройка OpenAI Images API
Генерация изображений не относится к обычному чат-интерфейсу. Даже если провайдер поддерживает текстовые модели, это вовсе не означает поддержку интерфейса изображений OpenAI. Перед настройкой проверьте у провайдера, прямо ли указаны «Images API», «генерация изображений» или соответствующая модель.
Официальная информация Загрузки и документация приведены в соответствии с официальным сайтом.
Сначала убедитесь, что провайдер поддерживает интерфейс изображений
| Что проверить | Как смотреть | Почему |
|---|---|---|
| Тип интерфейса | Упоминаются ли в панели управления или документации Images API, генерация изображений, редактирование изображений | Указание на совместимый с OpenAI чат-интерфейс не гарантирует доступность интерфейса изображений |
| Права на модели | Есть ли модели для работы с изображениями в списке и открыт ли к ним доступ у аккаунта или ключа | Модели изображений часто тарифицируются отдельно и активируются независимо от текстовых моделей |
| Путь запроса | Предоставил ли провайдер примеры вызова интерфейса изображений | Некоторые провайдеры проксируют только чат-интерфейс; прямой запрос к пути изображений вернет 404 |
| Цена | Изображения тарифицируются за штуку, размер или качество | Протестируйте на небольшом объеме перед пакетной генерацией во избежание резкого расхода средств |
Отличия от чат-интерфейса
| Тип | Обычные эндпоинты | Что требуется подготовить |
|---|---|---|
| Текстовый чат | /v1/chat/completions или Responses | Key, Base URL, имя модели, текст сообщения |
| Генерация изображений | /v1/images/generations | Key, модель изображений, промпт, размер, формат вывода |
| Редактирование изображений | Эндпоинт редактирования изображений | Помимо промпта, необходимо загрузить исходное изображение или маску |
Как заполнять поля
| Параметр конфигурации | Способ заполнения |
|---|---|
| Эндпоинт | https://api.openai.com/v1/images/generations |
| Модель | Официальный пример: <code>gpt-image-2</code>; для провайдеров указывайте в соответствии с их списком |
| Промпт | Какое изображение требуется сгенерировать |
| Размер | Размер изображения |
| Формат | URL или base64 |
Если вы используете провайдера, замените официальный домен на адрес API изображений, предоставленный провайдером; если провайдер явно не указал поддержку интерфейса изображений, не предполагайте по умолчанию, что он доступен. Включает ли Base URL /v1 — ориентируйтесь на примеры в панели управления, не пытайтесь угадать самостоятельно.
Пример запроса
Пример генерации изображений OpenAI
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'Стоимость вызова интерфейса изображений обычно отличается от текстового. Проверьте тарифы перед запуском пакетной генерации.
| Ошибка | Частые причины | Решения |
|---|---|---|
| 404 / endpoint not found | У провайдера нет проксируемого интерфейса изображений, либо в пути лишний или пропущенный слэш /v1 | Найдите в панели управления пример именно для интерфейса изображений; не используйте напрямую чат-интерфейс |
| model not found | Имя модели изображений отсутствует в списке текущего провайдера | Скопируйте точный ID или имя модели изображений, а не текстовой модели |
| unsupported content type | Интерфейс редактирования изображений требует загрузки файлов; нельзя передавать только JSON | Сначала проверьте, какой интерфейс вызывается: генерации или редактирования |