OneMux/Документация/Модели генерации изображений

Модели генерации изображений

Генерация и редактирование изображений через 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"
}

Указанные параметры поддерживаются не всеми моделями. Если интерфейс сообщает о неподдерживаемых параметрах, удалите необязательные параметры или проверьте возможности выбранной модели и канала.