GPT-Image-2-VIP Генерация изображений
Генерация изображений с помощью gpt-image-2-vip. Параметры совпадают с gpt-image-2, но поддерживаются все стандартные соотношения сторон.
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
- Унифицированный API генерации изображений
- Выбор модели
gpt-image-2-vipчерез параметрmodel - Параметры совпадают с
gpt-image-2 - Поддержка text-to-image, single-reference и multi-reference generation
- Асинхронное управление задачами с получением результата по task ID
Важное изменение: Для повышения производительности и контроля затрат base64 больше не поддерживается в image_urls и reference_images. Сначала используйте API загрузки изображений, затем передайте полученный URL.
Авторизация
AuthorizationstringзаголовокобязательноВсе API требуют аутентификации Bearer Token
Получите API Key на странице управления API ключами
Добавьте в заголовок:
Authorization: Bearer YOUR_API_KEYТело запроса
modelstringтелообязательнопо умолчанию: gpt-image-2-vipНазвание модели генерации изображений
Пример: "gpt-image-2-vip"
promptstringтелообязательноТекстовый промпт для генерации изображения
Максимум 32 000 символов для GPT image models
sizestringтелопо умолчанию: 1:1Соотношение сторон выходного изображения
Предустановленные соотношения:
1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21
Также можно передать любое соотношение в формате ширина:высота, например 1:3 или 7:4, с учетом ограничений ниже.
Можно передать auto, чтобы поставщик автоматически выбрал размеры, но итоговое соотношение сторон и размеры в пикселях не гарантируются.
resolutionstringтелопо умолчанию: 1kУровень разрешения изображения
Поддерживаемые значения: 1k, 2k, 4k
Произвольное разрешение
Помимо предустановленных соотношений выше, можно передать любое соотношение в формате ширина:высота через size. Сервис рассчитывает размеры в пикселях на основе выбранного уровня resolution. Результат должен соответствовать всем ограничениям:
- Обе стороны должны быть кратны 16 пикселям
- Длинная сторона не более 3 840 пикселей (4K)
- Соотношение сторон не более 3:1
- Общее количество пикселей от 655 360 до 8 294 400
Примеры:
size: "1:3"иresolution: "2k"→1024x3072size: "7:4"иresolution: "1k"→1344x768
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "Простой красный круг на белом фоне",
"size": "1:3",
"resolution": "2k",
"quality": "medium",
"n": 1
}'qualitystringтелопо умолчанию: mediumКачество изображения
low— быстро и экономично, для черновиков/превьюmedium— баланс скорости и качестваhigh— максимальная детализация, подходит для финальных изображений
backgroundstringтелопо умолчанию: autoСтиль фона генерируемого изображения
auto— модель решает автоматически (по умолчанию)transparent— прозрачный фонopaque— непрозрачный фон
nintegerтелопо умолчанию: 1Количество изображений
По умолчанию: 1
response_formatstringтелопо умолчанию: urlФормат ответа
API возвращает URL изображения, рекомендуемое значение: url
reference_imagesstring[]телоURL эталонных изображений для image-to-image
⚠️ Только URL (base64 больше не поддерживается)
- Публично доступные URL (
http://илиhttps://) - Можно использовать API загрузки изображений для загрузки локальных файлов
- Поддерживаются одиночные и множественные reference images
image_urlsstring[]телоПоле обратной совместимости
В ToAPIs автоматически нормализуется в reference_images
callback_urlstringтелоСтандартный callback завершения ToAPIs. Настройте HTTPS URL и secret Token; разрешено только same-origin переопределение. См. Webhook.
Ответ
idstringУникальный идентификатор задачи
objectstringТип объекта, всегда generation.task
modelstringИспользуемая модель
statusstringСтатус задачи
queuedin_progresscompletedfailed
progressintegerПрогресс задачи (0-100)
created_atintegerВремя создания задачи (Unix timestamp)
Пример запроса
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "Сгенерируй широкоформатный кинематографичный постер ночного города будущего с неоном",
"n": 1,
"size": "16:9",
"resolution": "2k",
"quality": "high",
"response_format": "url"
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-vip",
"prompt": "Сохрани структуру сцены, но сделай стиль киберпанк с усиленным светом и деталями",
"n": 1,
"size": "9:16",
"resolution": "4k",
"quality": "medium",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-image-2-vip',
prompt: 'Сгенерируй широкоформатный кинематографичный постер ночного города будущего с неоном',
n: 1,
size: '16:9',
resolution: '2k',
quality: 'low',
response_format: 'url'
})
});
const task = await response.json();
console.log(task.id, task.status);Пример ответа
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2-vip",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}