GPT Image 2.5 API
GPT Image 2.5 API создаёт и редактирует изображения по тексту и референсам. Текущая интеграция NexusAPI поддерживает только разрешение 1K; варианты 2K и 4K в этом контракте отсутствуют.
Редакция NexusAPI · параметры и цены проверены
Цены GPT Image 2.5 API
| Модель / режим | model_name | Ставка | Единица |
|---|---|---|---|
| GPT Image 2.5 · Базовая ставка | gpt-image-2.5 | 2 | ₽ за запуск |
Ставки взяты из публичного каталога. Проверяйте единицу тарифа: секунда, запуск или запрос. Настройки и фактические условия аккаунта могут влиять на итоговую стоимость; актуальные данные доступны в каталоге перед запуском.
Каталог публикует 2 ₽ за запуск без отдельных pricingOptions по quality. Проверяйте текущую ставку перед серией запросов.
Параметры и ограничения GPT Image 2.5
- Обязательны непустой prompt и model_name: gpt-image-2.5. Для базового запроса задайте resolution: 1K; image_size — необязательный псевдоним того же значения.
- Для редактирования используйте image_url с одним изображением либо image_urls с максимум четырьмя. Эти два поля нельзя сочетать в одном запросе.
- quality принимает auto, low, medium или high. aspect_ratio: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 или 2:3.
- Контракт запрещает неизвестные поля. Не переносите настройки другого image endpoint без проверки: здесь запрос вложен в params и обрабатывается асинхронно.
| Поле | Тип | Обязательно | Значения и ограничения |
|---|---|---|---|
prompt | строка | да | Длина строки: 1 … максимум не указан |
webhook_url | строка | нет | Числовой предел в схеме не задан |
model_name | строка | да | Только gpt-image-2.5 |
aspect_ratio | строка | нет | Допустимо: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; По умолчанию: "auto" |
resolution | строка | нет | Только 1K; По умолчанию: "1K" |
image_size | строка | нет | Только 1K |
quality | строка | нет | Допустимо: auto, low, medium, high; По умолчанию: "auto" |
image_urls | массив | нет | Не более 4 элементов |
image_url | строка | нет | Числовой предел в схеме не задан |
Пример запроса GPT Image 2.5
Создайте аккаунт в панели NexusAPI, выпустите API-ключ и сохраните его на сервере в переменной NEXUS_API_KEY. Ключ не следует помещать в публичный JavaScript. Пример показывает структуру запроса и не является отчётом о выполненной генерации.
curl https://nexusapi.dev/generate \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"params": {
"model_name": "gpt-image-2.5",
"prompt": "Студийная фотография синей керамической чашки на светлом фоне, мягкая тень",
"resolution": "1K",
"aspect_ratio": "1:1"
}
}
JSONPOST /generate принимает объект params и возвращает task_id. Сохраните ID и опрашивайте статус до завершения либо передайте webhook_url в params. Не повторяйте создание задачи только потому, что результат ещё не готов.
curl "https://nexusapi.dev/tasks/$TASK_ID" \
-H "Authorization: Bearer $NEXUS_API_KEY"В TASK_ID подставьте идентификатор из первого ответа. Формат завершённого результата проверяйте по текущей документации; не предполагайте заранее фиксированное число файлов.
Проверка перед запуском
- Сверьте точный model_name, обязательные поля и допустимые значения в схеме выбранного варианта.
- Используйте только доступные серверу ссылки на исходные материалы; для первого теста начните с простого текстового запроса, где это допустимо.
- После завершения проверьте содержание, формат и пригодность результата. Только после проверки отправляйте серию задач.