Mage API · Модель изображений
GPT Image 2 API
Точные промпты и читаемый текст
POST https://api.mage.space/v1/gpt_image_2/generateГлавное
API GPT Image 2 запускает GPT Image 2 и ещё 4 варианта через Mage по адресу POST https://api.mage.space/v1/gpt_image_2/generate. Запрос с настройками по умолчанию стоит 9 Gems (около $0,009), без подписки. GPT Image 2 принимает сохранённых персонажей и референсы по @handle в промпте.
- ИзображениеРезультат
- 5Варианты
- 9Gems за изображение по умолчанию
- $0.009Примерно, в USD
Обзор
Что умеет GPT Image 2 API
Модели OpenAI GPT Image, которые точно следуют промпту и выдают читаемый текст. Создавайте и редактируйте изображения по множеству референсов или делайте анимированные GIF на GPT Image 2.6. Действует фильтр безопасности OpenAI.
Модели OpenAI GPT Image для генерации и редактирования: GPT Image 2, GPT Image 2.5 Flare и Sunburst, а также GPT Image 2.6 Flare и Sunburst, которые умеют делать и анимированные GIF. Действует фильтр безопасности OpenAI.
На вход принимает image, additional_images.
Быстрый старт
Вызов API GPT Image 2
Задайте MAGE_API_KEY, отправьте запрос на /gpt_image_2/generate и опрашивайте status_url, пока запрос не выполнится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('gpt_image_2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'gpt-image-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("gpt_image_2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2",
})
print(request["result"]["url"])Модели
Значения model_id для GPT Image 2
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| gpt-image-2 | GPT Image 2 | Да |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | |
| gpt-image-2.5-sunburst | GPT Image 2.5 Sunburst | |
| gpt-image-2.6-flare | GPT Image 2.6 Flare | |
| gpt-image-2.6-sunburst | GPT Image 2.6 Sunburst |
Параметры
Параметры GPT Image 2
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
| output_format | jpeg, gif |
Входные данные
Какие медиафайлы принимает GPT Image 2
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсное изображение. |
| additional_images | Дополнительные референсные изображения. |
Правила
Что проверяет API GPT Image 2
- У каждой модели доступны только некоторые уровни `quality`; уровень, которого нет у выбранной модели, отклоняется.
- Чтобы получить анимированный GIF, задайте для модели GPT Image 2.6 `output_format` со значением `gif`, `frame_count` от 2 до 16 (по умолчанию 9) и `frame_duration_ms` от 20 до 2000 (по умолчанию 200). Другие модели такое значение отклоняют. `resolution` не применяется: для каждого `aspect_ratio` задан один размер кадра, около 640 пикселей. Результат — файл `.gif`, а его `type` остаётся `image`.
- Цена GIF зависит от `quality` и от диапазона кадров (2–8, 9, 10–12 или 13–16), а не от каждого кадра отдельно. В таблице цен ниже указаны статичные изображения: цену GIF смотрите в оценке стоимости.
- GIF, сгенерированный в Mage (например, предыдущий результат), можно передать как изображение на входе — тогда будет использован его первый кадр. GIF из других источников не принимается: в качестве входных изображений поддерживаются только JPEG и PNG.
Другие модели изображений
Другие API для генерации изображений на Mage
Grok Image API
Grok Imagine в двух вариантах
Guava API
Фотореализм, неотличимый от настоящего снимка
HiDream API
Быстрая и универсальная, с негативными промптами
Krea 2 API
Потрясающая эстетика за секунды
Mango API
Наше флагманское семейство моделей для изображений
MiniMax H3 Image API
Нативные изображения 16 мегапикселей, открытые веса
FAQ
Частые вопросы
Сколько стоит API GPT Image 2?
Какой endpoint у API GPT Image 2?
Какие модели GPT Image 2 можно вызывать?
Поддерживает ли GPT Image 2 референсы и персонажей?
Можно ли использовать GPT Image 2 из Claude или ChatGPT?
Как долго хранятся результаты GPT Image 2?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.