Текст в изображение
Генерация изображения по текстовому промпту.
Не пишете код? См. Генерация изображений в ваших инструментах.
Перед началом
https://api.ofox.ai/v1openai/gpt-image-2.5-flarepip install openaiКод
Каждый пример ниже был запущен в неизменном виде. Результат сохраняется в файл output.png в текущем каталоге.
cURL
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)
- Размер
size: ширина и высота кратны 16, длинная сторона ≤ 3840, соотношение сторон от 1:3 до 3:1, всего пикселей ≥ 655 360.768x768не подходит;1024x768работает. Если не указан, размер выбирает модель; в наших тестах это было 1254×1254. См. Размер. - Качество
quality: сначала добейтесь работы наlow, затем повышайте. Отсутствие параметра не равноmedium— модель выбирает уровень сама. Уgpt-image-2нетxhighиmax. Расход по уровням — в разделе Качество.
Значения параметров
Допустимые значения и измеренные значения по умолчанию для этого семейства. Для size и quality см. разделы Размер и Качество на обзорной странице.
openai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2Регистрозависимый; при неверном регистре возвращается 404. Указывайте полный ID с префиксом openai/.
Каждое изображение оплачивается отдельно. Значение больше 10 возвращает 400.
Работа всех трёх форматов подтверждена замерами.
▶Дополнительные · 4output_compression · background · moderation · partial_imagesExpand
Применяется только к jpeg и webp.
Для прозрачного фона нужен png или webp; jpeg не поддерживает прозрачность.
Строгость модерации контента.
Используется вместе с stream: true: сколько промежуточных изображений отправлять во время генерации.
Распространённые ошибки
Другие ошибки см. в полной таблице ошибок.
Официальная документация
Документация OpenAI описывает поведение при прямом обращении к OpenAI. При вызове через OfoxAI приоритет имеют результаты замеров из этого раздела. Например, для редактирования не нужно закреплять провайдера.