Модели генерации изображений
Генерация и редактирование изображений через API моделей изображений OneMux.
Описание API
Для моделей изображений используется отдельный интерфейс Images. Не отправляйте запросы на генерацию изображений в /v1/chat/completions.
- Генерация изображений:
POST https://api.onemux.net/v1/images/generations - Редактирование изображений:
POST https://api.onemux.net/v1/images/edits - Аутентификация:
Authorization: Bearer YOUR_API_KEY - Модель: используйте фактический ID модели изображений, возвращаемый интерфейсом списка текущих моделей
Сначала получите список доступных моделей:
curl https://api.onemux.net/v1/models \
-H "Authorization: Bearer $ONEMUX_API_KEY"
Поддержка генерации, редактирования, референсных изображений, размеров, качества, форматов вывода и других параметров зависит от модели и фактических возможностей вышестоящего сервиса.
Генерация изображений
Отправьте запрос на генерацию изображения по текстовому описанию через /v1/images/generations.
curl https://api.onemux.net/v1/images/generations \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
"size": "1024x1024",
"quality": "medium"
}'
Часто используемые параметры:
| Параметр | Обязательный | Описание |
|---|---|---|
model | Да | ID доступной модели изображений |
prompt | Да | Описание содержимого изображения |
size | Нет | Размер изображения; поддерживаемый диапазон зависит от модели |
quality | Нет | Качество изображения; допустимые значения зависят от модели |
n | Нет | Количество генерируемых изображений; поддерживаемый диапазон зависит от модели |
response_format | Нет | b64_json или url; доступно только для поддерживающих это моделей |
background | Нет | Прозрачный или непрозрачный фон; доступно только для поддерживающих это моделей |
output_format | Нет | png, jpeg, webp; доступно только для поддерживающих это моделей |
Не используйте параметры, поддерживаемые одной моделью, для других моделей изображений. При ошибках model_not_found, invalid_model или ошибках о неподдерживаемых параметрах сначала проверьте ID модели и ее возможности.
Редактирование изображений
Используйте /v1/images/edits для редактирования существующих изображений. В распространенных моделях изображений, совместимых с OpenAI, для загрузки изображений используется multipart/form-data:
curl https://api.onemux.net/v1/images/edits \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-F "model=YOUR_IMAGE_MODEL_ID" \
-F "image[]=@input.png" \
-F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
-F "size=1024x1024"
Можно передавать несколько референсных изображений, повторяя image[], например:
-F "image[]=@person.png" \
-F "image[]=@product.png"
Количество и формат изображений, маски, URL референсных изображений и формат редактирования JSON зависят от модели и вышестоящего канала. Используйте эти параметры, только если модель явно их поддерживает.
Вызов из Python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["ONEMUX_API_KEY"],
base_url="https://api.onemux.net/v1",
)
result = client.images.generate(
model="YOUR_IMAGE_MODEL_ID",
prompt="一张简洁的蓝色科技风产品海报",
size="1024x1024",
)
print(result.data[0].b64_json or result.data[0].url)
Для редактирования изображений обычно требуется напрямую отправлять файлы в формате multipart. Если текущая версия Python SDK не поддерживает параметры редактирования целевой модели, используйте приведенный выше запрос cURL.
Результат
Успешный ответ обычно содержит массив data:
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}
Некоторые модели возвращают URL изображения, если в запросе response_format задан как url:
{
"created": 1760000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
При получении Base64 сохраните файл в соответствии с фактическим форматом изображения. Если получен URL, своевременно скачайте и сохраните изображение самостоятельно, чтобы временная ссылка не успела истечь.
Оплата
Для моделей изображений не используется единая тарификация по Token. OneMux рассчитывает стоимость по действующим правилам тарификации модели. Возможны следующие варианты:
- Оплата за количество сгенерированных изображений
- Оплата в зависимости от разрешения изображения или уровня качества
- Оплата за входные и выходные Token изображения или другие показатели использования вышестоящего сервиса
Актуальные цены, единицы тарификации и поддерживаемые характеристики указаны в описании соответствующей модели в каталоге моделей. Сбой запроса обычно не приводит к оплате изображения, которое соответствовало бы успешному результату, но точное поведение зависит от отображаемой на странице информации и ответа сервера.
Часто задаваемые вопросы
Почему нельзя генерировать изображения через интерфейс диалога?
Для моделей изображений используется отдельный маршрут Images. При отправке запроса на /v1/chat/completions или другой неподходящий интерфейс может вернуться ошибка о том, что модель не поддерживает эту конечную точку или параметры.
Почему модель находится в списке, но запрос все равно завершается ошибкой?
Проверьте, разрешена ли для модели генерация или редактирование изображений, есть ли у текущего API Key нужные права, входят ли параметры запроса в перечень поддерживаемых моделью и доступен ли соответствующий вышестоящий канал.
Почему вместо ссылки на изображение возвращается Base64?
Формат ответа зависит от модели или настройки response_format. При получении b64_json необходимо самостоятельно декодировать и сохранить данные на клиенте; при получении url нужно скачать изображение по возвращенному адресу.
Что делать, если генерация изображения занимает много времени?
Запросы с высоким разрешением, высоким качеством или сложным редактированием могут выполняться дольше. Настройте разумный таймаут запроса на клиенте. Не отправляйте тот же запрос повторно только потому, что истек таймаут на клиенте: это может создать дублирующие задачи или привести к дополнительной оплате.
GPT Image 2.6: SVG, GIF и сложность
В серии GPT Image 2.6 появились вывод SVG, анимированного GIF и параметр complexity. Эти возможности доступны только в моделях и вышестоящих каналах, которые их поддерживают.
Вывод SVG
SVG используется для генерации изображений, но не для их редактирования. При вызове интерфейса генерации задайте output_format равным svg, а n установите в 1. Данные изображения в ответе представлены в Base64; после декодирования сохраните их в файл .svg.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一个简洁的蓝色几何图形标志",
"output_format": "svg",
"n": 1
}
Для некоторых конфигураций вышестоящих сервисов может потребоваться дополнительный объект svg, например svg.model. Добавляйте его только в том случае, если это явно указано в документации модели или канала. Не все модели изображений и каналы поддерживают SVG.
Вывод анимированного GIF
Для моделей GPT Image 2.6, поддерживающих эту возможность, в интерфейсе генерации изображений можно задать output_format равным gif. Если модель это поддерживает, используйте frame_count и frame_duration_ms для настройки количества кадров анимации и длительности каждого кадра. GIF относится к возможностям генерации: не предполагайте, что интерфейс редактирования изображений тоже может возвращать GIF.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一只蓝色小鸟循环拍打翅膀的动画",
"output_format": "gif",
"frame_count": 6,
"frame_duration_ms": 200
}
Параметр сложности
Серия GPT Image 2.6 поддерживает complexity со значениями low, medium и high. Для простых изменений можно попробовать низкую сложность, а для изображений с большим количеством текста или сложной композицией — высокую. Этот параметр отличается от quality. При высокой сложности генерация может занять больше времени.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一张细节丰富的城市街景编辑插画",
"complexity": "high",
"quality": "high"
}
Указанные параметры поддерживаются не всеми моделями. Если интерфейс сообщает о неподдерживаемых параметрах, удалите необязательные параметры или проверьте возможности выбранной модели и канала.