Skip to Content
МоделиGPT ImageТекст в изображение

Текст в изображение

Генерация изображения по текстовому промпту.

Перед началом

Что нужноПодробности
API-ключСоздайте его в консоли OfoxAI  и замените YOUR_OFOX_API_KEY в коде
ОкружениеДля cURL нужен jq для декодирования изображения; для Python — pip install openai; для Node.js — версия 18 или выше, без зависимостей
ТаймаутУстановите таймаут клиента 600 секунд. Высокое качество, большие размеры или редактирование могут занимать несколько минут
Значения, используемые в коде
Адрес APIhttps://api.ofox.ai/v1
ID моделиopenai/gpt-image-2.5-flare
API-ключЗамените YOUR_OFOX_API_KEY в коде на свой ключ
Зависимости Pythonpip install openai

Код

Каждый пример ниже был запущен в неизменном виде. Результат сохраняется в файл output.png в текущем каталоге.

Terminal
curl -s https://api.ofox.ai/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "A red apple on a white table, soft natural light", "size": "1024x1024", "quality": "low" }' \ -o response.json # Изображение возвращается в base64 — декодируем и сохраняем (нужен jq; при ошибке смотрите response.json) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Частые изменения

Измените один параметр в запросе выше:

Чтобы получитьИзменитеПримечания
Другой размерsizeПроизвольный размер должен соответствовать четырём правилам
Более высокое качествоqualityЧем выше уровень, тем дороже и дольше — см. Качество
Файлы меньшего размераoutput_format, output_compressionПереключитесь на jpeg или webp, затем задайте степень сжатия
Несколько изображенийn1–10, каждое оплачивается отдельно

Размер (size) и качество (quality)

  • Размер size: ширина и высота кратны 16, длинная сторона ≤ 3840, соотношение сторон от 1:3 до 3:1, всего пикселей ≥ 655 360. 768x768 не подходит; 1024x768 работает. Если не указан, размер выбирает модель; в наших тестах это было 1254×1254. См. Размер.
  • Качество quality: сначала добейтесь работы на low, затем повышайте. Отсутствие параметра не равно medium — модель выбирает уровень сама. У gpt-image-2 нет xhigh и max. Расход по уровням — в разделе Качество.

Значения параметров

Допустимые значения и измеренные значения по умолчанию для этого семейства. Для size и quality см. разделы Размер и Качество на обзорной странице.

Обязательные
modelобязательныйstring· значенияopenai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

Регистрозависимый; при неверном регистре возвращается 404. Указывайте полный ID с префиксом openai/.

Основные
ninteger· по умолчанию 1· значения1–10

Каждое изображение оплачивается отдельно. Значение больше 10 возвращает 400.

output_formatstring· по умолчанию png· значенияpngjpegwebp

Работа всех трёх форматов подтверждена замерами.

▶Дополнительные · 4output_compression · background · moderation · partial_imagesExpand
output_compressioninteger· значения0–100

Применяется только к jpeg и webp.

backgroundstring· по умолчанию opaque· значенияopaquetransparentauto

Для прозрачного фона нужен png или webp; jpeg не поддерживает прозрачность.

moderationstring· значенияautolow

Строгость модерации контента.

partial_imagesinteger· значения0–3

Используется вместе с stream: true: сколько промежуточных изображений отправлять во время генерации.

Распространённые ошибки

ОшибкаПричинаРешение
moderation_blockedПромпт заблокирован системой безопасности на стороне поставщика моделиИзмените промпт и повторите попытку; повтор без изменений даст тот же результат
Transparent background is not supported for JPEG output formatЗапрошен прозрачный фон при выводе в jpegИспользуйте png или webp
404 model_not_foundОшибка в написании идентификатора модели или неверный регистрСкопируйте идентификатор модели с этой страницы
Invalid sizeРазмер нарушает одно из четырёх правил вышеИсправьте его, как описано в разделе Размер и качество
does not support quality 'xhigh'xhigh или max отправлены для gpt-image-2Используйте high или перейдите на 2.5
Invalid value: 'standard'Для quality указано standard или hdИспользуйте значения от low до max
429 rate_limit_exceededБолее 100 запросов в минуту (на команду)Повторите попытку позже

Другие ошибки см. в полной таблице ошибок.

Официальная документация

Документация OpenAI описывает поведение при прямом обращении к OpenAI. При вызове через OfoxAI приоритет имеют результаты замеров из этого раздела. Например, для редактирования не нужно закреплять провайдера.

Last updated on