GPT Image 2 API
Эндпоинты и аутентификация
TeamoRouter использует формат, совместимый с OpenAI Images API:
- Генерация изображений:
POST https://api.teamorouter.com/v1/images/generations - Редактирование изображений:
POST https://api.teamorouter.com/v1/images/edits
Заголовки запроса:
Authorization: Bearer sk-teamo-xxxxxx
Content-Type: application/json
Эндпоинт редактирования также принимает multipart/form-data для загрузки файлов изображений.
Генерация изображений
Минимальный запрос:
curl https://api.teamorouter.com/v1/images/generations \
-H "Authorization: Bearer sk-teamo-xxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "An orange tabby cat typing on a keyboard, illustration style"
}'
Укажите размер и качество:
{
"model": "gpt-image-2",
"prompt": "An orange tabby cat typing on a keyboard, illustration style",
"size": "2048x2048",
"quality": "high"
}
Основные параметры:
| Параметр | Описание |
|---|---|
model |
Используйте gpt-image-2. |
prompt |
Описание изображения, которое нужно сгенерировать. |
size |
auto или ширинаxвысота, например 1024x1024, 2048x2048, 3840x2160. |
quality |
low, medium, high или auto. |
n |
Число изображений за запрос. По умолчанию 1. |
output_format |
png, jpeg или webp. |
output_compression |
Уровень сжатия JPEG/WebP, от 0 до 100. |
background |
transparent, opaque или auto. При transparent возвращаемое изображение содержит альфа-канал; сочетайте с output_format png или webp. |
moderation |
Строгость модерации контента, low или auto. |
stream |
true — ответ приходит потоком по SSE: у промежуточных фрагментов потока (чанков) object равен image.generation.chunk, у финального — image.generation.result с изображением в data[0].b64_json, затем data: [DONE]. |
partial_images |
От 0 до 3. Сейчас промежуточные фрагменты не содержат изображения; результат только в финальном фрагменте. |
user |
Идентификатор конечного пользователя в вашем приложении, передаётся как есть. |
Ограничения OpenAI на размер для gpt-image-2: длинная сторона не более 3840 пикселей; ширина и высота кратны 16; соотношение сторон не более 3:1; общее число пикселей от 655 360 до 8 294 400. Размеры задаются в пикселях, а не фиксированными строками 1k, 2k, 4k.
Редактирование изображений
curl https://api.teamorouter.com/v1/images/edits \
-H "Authorization: Bearer sk-teamo-xxxxxx" \
-F "model=gpt-image-2" \
-F "prompt=Replace the background with snowy mountains" \
-F "image=@input.png" \
-F "size=1024x1024"
Основные параметры:
| Параметр | Описание |
|---|---|
model |
Используйте gpt-image-2. |
image |
Файл исходного изображения. |
mask |
Файл маски; прозрачные области редактируются. Размеры маски должны совпадать с размерами исходного изображения. |
prompt |
Инструкция по редактированию. |
n |
Число изображений за запрос. По умолчанию 1. |
size |
auto или ширинаxвысота. |
quality |
low, medium, high или auto. |
background |
transparent, opaque или auto. По результатам тестов изображения из эндпоинта редактирования не содержат альфа-канала. |
input_fidelity |
Насколько точно сохранять детали исходного изображения, high или low. |
output_format |
png, jpeg или webp. |
output_compression |
Уровень сжатия JPEG/WebP, от 0 до 100. |
stream |
true — ответ приходит потоком по SSE. Формат событий зависит от канала провайдера: чаще всего он совпадает с генерацией; возможны и нативные события OpenAI, заканчивающиеся event: image_generation.completed, с изображением в b64_json этого события. |
partial_images |
От 0 до 3. |
user |
Идентификатор конечного пользователя в вашем приложении, передаётся как есть. |
Размеры и правила тарификации
Генерация изображений тарифицируется за изображение. Цена каждого изображения определяется его фактическим разрешением по трём ступеням в зависимости от длинной стороны:
| Длинная сторона результата, пикселей | Ступень |
|---|---|
| До 1024 включительно | 1K |
| 1025–2048 | 2K |
| Более 2048 | 4K |
Ступень определяется фактической шириной и высотой возвращённого изображения, а не параметрами запроса. Если size равен auto, не указан или пуст, тарификация идёт по размеру, который реально выдала модель; без size модель по умолчанию выдаёт 1024 или 1254 пикселя, что тарифицируется как 1K или 2K соответственно. Если нужна фиксированная ступень, укажите size явно. Цены трёх ступеней смотрите в разделе актуальные цены.