Перейти к содержимому

Генерация изображений ​

Генерация изображений — не обычный чат

Замена имени текстовой модели на 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/generationshttps://1app.ru/v1
Прямой HTTP-запрос, например через curlhttps://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, приватные изображения и ссылки на них. Другие причины — в разделе Ошибки.