curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2",
"prompt": "Сгенерируй постер ночного города будущего с неоном и кинематографичной композицией",
"n": 1,
"size": "1:1",
"resolution": "1k",
"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",
"prompt": "保留主体结构，把画面改成赛博朋克风格，增强光影和细节",
"n": 1,
"size": "1:1",
"resolution": "1k",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
GPT-Image-2
GPT-Image-2 Генерация изображений
Генерация изображений с помощью gpt-image-2, поддержка text-to-image и generation по reference_images
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2",
"prompt": "Сгенерируй постер ночного города будущего с неоном и кинематографичной композицией",
"n": 1,
"size": "1:1",
"resolution": "1k",
"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",
"prompt": "保留主体结构，把画面改成赛博朋克风格，增强光影和细节",
"n": 1,
"size": "1:1",
"resolution": "1k",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
Для пользователей из материкового Китая: используйте
https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.- Унифицированный API генерации изображений
- Выбор модели
gpt-image-2через параметрmodel - Поддержка text-to-image, single-reference и multi-reference generation
- Асинхронное управление задачами с получением результата по task ID
Важное изменение: Для повышения производительности и контроля затрат base64 больше не поддерживается в
image_urls и reference_images. Сначала используйте API загрузки изображений, затем передайте полученный URL.Авторизация
string
обязательно
Все API требуют аутентификации Bearer TokenПолучите API Key на странице управления API ключамиДобавьте в заголовок:
Authorization: Bearer YOUR_API_KEY
Тело запроса
string
по умолчанию:"gpt-image-2"
обязательно
Название модели генерации изображенийПример:
"gpt-image-2"string
обязательно
Текстовый промпт для генерации изображенияМаксимум 32 000 символов для GPT image models
string
по умолчанию:"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:21string
по умолчанию:"1k"
Уровень разрешения изображенияПоддерживаемые значения:
1k, 2k, 4kТаблица размеров
| size | 1k | 2k | 4k |
|---|---|---|---|
1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
3:2 | 1536x1024 | 2048x1360 | 3520x2336 |
2:3 | 1024x1536 | 1360x2048 | 2336x3520 |
4:3 | 1024x768 | 2048x1536 | 3312x2480 |
3:4 | 768x1024 | 1536x2048 | 2480x3312 |
5:4 | 1280x1024 | 2560x2048 | 3216x2576 |
4:5 | 1024x1280 | 2048x2560 | 2576x3216 |
16:9 | 1536x864 | 2048x1152 | 3840x2160 |
9:16 | 864x1536 | 1152x2048 | 2160x3840 |
2:1 | 2048x1024 | 2688x1344 | 3840x1920 |
1:2 | 1024x2048 | 1344x2688 | 1920x3840 |
21:9 | 2016x864 | 2688x1152 | 3840x1648 |
9:21 | 864x2016 | 1152x2688 | 1648x3840 |
integer
по умолчанию:1
Количество изображенийПо умолчанию: 1
string
по умолчанию:"url"
Формат ответаAPI возвращает URL изображения, рекомендуемое значение:
urlstring[]
URL эталонных изображений для image-to-image⚠️ Только URL (base64 больше не поддерживается)
- Публично доступные URL (
http://илиhttps://) - Можно использовать API загрузки изображений для загрузки локальных файлов
- Поддерживаются одиночные и множественные reference images
- Максимум 6 изображений
string[]
Поле обратной совместимостиВ ToAPIs автоматически нормализуется в
reference_imagesОтвет
string
Уникальный идентификатор задачи
string
Тип объекта, всегда
generation.taskstring
Используемая модель
string
Статус задачи
queuedin_progresscompletedfailed
integer
Прогресс задачи (0-100)
integer
Время создания задачи (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",
"prompt": "Сгенерируй постер ночного города будущего с неоном и кинематографичной композицией",
"n": 1,
"size": "1:1",
"resolution": "1k",
"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",
"prompt": "保留主体结构，把画面改成赛博朋克风格，增强光影和细节",
"n": 1,
"size": "1:1",
"resolution": "1k",
"image_urls": [
"https://example.com/source.png",
"https://example.com/source.png",
"https://example.com/source.png"
],
"response_format": "url"
}'
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gpt-image-2",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}