Оформление
Генерация изображений
Генерация изображений — не обычный чат
Замена имени текстовой модели на gpt-image-* не меняет endpoint и формат запроса. Для описанных ниже моделей используйте POST /v1/images/generations.
Если клиент отправляет запросы только в /v1/chat/completions, одной настройки Base URL и Model ID недостаточно. Нужен режим генерации изображений через Images API.
Как выбрать endpoint
Endpoint — это HTTP-метод и путь конкретной операции. Выбирайте его по модели и задаче, а не по названию клиента.
| Модель | Задача | Метод и endpoint |
|---|---|---|
gpt-image-2 | Генерация по описанию | POST /v1/images/generations |
gpt-image-2.5 | Генерация по описанию | POST /v1/images/generations |
gpt-image-2.5-flare | Генерация по описанию | POST /v1/images/generations |
gpt-image-2.5-sunburst | Генерация по описанию | POST /v1/images/generations |
gpt-image-2.6-flare | Генерация по описанию | POST /v1/images/generations |
gpt-image-2.6-sunburst | Генерация по описанию | POST /v1/images/generations |
Доступность может меняться; точное имя выбирайте в каталоге моделей.
Модели относятся к группе Media. Выберите её для токена либо используйте auto, если Media доступна вашему аккаунту через автоматический выбор. Проверочный запрос выполнен через auto. Подробнее — группы токенов.
Что не подтверждено
Поддержка редактирования через /v1/images/edits для этих моделей не подтверждена. Не заменяйте путь генерации на путь редактирования без отдельной проверки модели и формата загрузки файла.
Генерация через /v1/responses и /v1/chat/completions здесь также не подтверждена. Общая метка OpenAI-совместимости в каталоге не гарантирует генерацию изображений через текстовый интерфейс. Эти маршруты могут работать для других задач и моделей.
Base URL и полный URL запроса
| Где задаётся адрес | Что указать |
|---|---|
Поле Base URL клиента, который сам добавляет /images/generations | https://1app.ru/v1 |
| Прямой HTTP-запрос, например через curl | https://1app.ru/v1/images/generations |
Не вставляйте полный endpoint в поле Base URL, если клиент сам добавляет путь операции. Иначе получится повторный путь. Если клиент уже добавляет /v1, задайте адрес по его инструкции, чтобы не получить /v1/v1/....
В настройках клиента проверьте режим Images / Генерация изображений, точное имя модели и поддержку ответа с URL или Base64. Наличие поля Model ID само по себе не означает поддержку Images API.
Минимальный запрос
Замените <ВАШ_API_KEY> своим ключом 1APP. Не отправляйте ключ в чат или поддержку. Команда с подставленным ключом может сохраниться в истории терминала и быть видна в списке процессов.
Расход средств
Запрос создаёт одно изображение и расходует баланс. Не запускайте его многократно для проверки настроек. Сначала сверьте endpoint и группу токена.
bash
curl --silent --show-error --fail-with-body --max-time 180 \
'https://1app.ru/v1/images/generations' \
-H 'Authorization: Bearer <ВАШ_API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-image-2.6-flare","prompt":"A single blue circle on a white background.","n":1}'JSON-ответ появится в терминале. При ошибке прочитайте поле error, не считайте ответ готовым изображением. Не включайте подробное логирование заголовков с ключом.
Как получить картинку из ответа
В проверенном ответе HTTP 200 поле data[0].url содержало ссылку на изображение. Сокращённая схема ответа:
json
{
"data": [
{ "url": "https://example.com/generated-image.png" }
]
}Адрес выше — пример, не готовая картинка. Откройте фактический data[0].url из своего ответа в браузере и сохраните изображение. Не передавайте API-ключ 1APP серверу из этой ссылки. Ссылка может быть временной; не публикуйте её, если изображение приватное.
Если другой поддерживаемый вариант ответа возвращает data[0].b64_json, декодируйте значение из Base64 и сохраните полученные байты в файл изображения. Это не URL. В контрольном запросе Base64-ответ не проверялся; не добавляйте response_format, size или quality без проверки поддержки конкретной модели.
Почему не работает
| Симптом | Что проверить |
|---|---|
| Ошибка неподдерживаемого интерфейса | Метод, путь и формат тела. Для примера выше нужны /v1/images/generations и prompt, а не чатовый массив messages |
| 404 | Адрес сервера, путь, повторный /v1 и полный endpoint вместо Base URL. Неверный endpoint — только одна из возможных причин |
| Нет доступных каналов | Точное имя модели, доступ к Media, группу токена и текущую доступность поставщика |
| Клиент отвечает текстом или не показывает картинку | Поддержку Images API и обработку data[].url / data[].b64_json в клиенте |
| Генерация работает, редактирование — нет | Поддержку редактирования у модели и формат загрузки изображения. Поддержка генерации не означает поддержку редактирования |
| 401 или недостаточно квоты | Ключ, лимит токена и баланс; смена endpoint не исправит эти ошибки |
Если ошибка остаётся, отправьте поддержке название и версию клиента, модель, HTTP-метод и путь, статус, текст ошибки и время запроса. Удалите из материалов API-ключи, заголовок Authorization, приватные изображения и ссылки на них. Другие причины — в разделе Ошибки.