Справочник разработчика

Документация API GPT Image 2.6

Создайте ключ API, отправьте запрос на генерацию и проверьте задачу, чтобы получить изображение.

Создайте ключ API

Войдите в аккаунт и создайте ключ. Перед запуском примеров задайте его как GPT_IMAGE_API_KEY в окружении своего сервера.

Управление ключами API

Храните ключ на сервере. Оба метода используют пользовательский ключ API в заголовке Authorization: Bearer; cookie браузера не требуются.

Запросы на генерацию расходуют кредиты вашего аккаунта. При одинаковых настройках стоимость Flare и Sunburst в кредитах одинакова. Текущая стоимость изображений

Отправьте запрос на генерацию

POST /api/generate

Сохраните JSON ниже в файл request.json. Пример создаёт изображение по тексту. Для редактирования по образцам добавьте описанный ниже массив images.

Тело запроса: `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "Синяя керамическая чашка на деревянном столе на фоне бумаги тёплого оттенка.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

Отправка с вашего сервера

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

При успешной отправке возвращаются code 200, data.task_id, data.status со значением IN_PROGRESS и data.consumed_credits. Сохраните data.task_id для проверки статуса.

Поля запроса

Поле	Назначение и допустимые значения
`model`	Используйте gpt-image-2.6. Эта модель также выбирается по умолчанию, если поле отсутствует.
`variant`	Необязательно: flare, sunburst. По умолчанию: flare. Для Sunburst укажите sunburst.
`prompt`	Обязательный текст длиной от 1 до 20000 символов после удаления пробелов по краям.
`quality`	Необязательно: low, medium, high, xhigh, max. По умолчанию: medium.
`resolution`	Необязательно: 1k, 2k, 4k. По умолчанию: 1k.
`complexity`	Планирование композиции, необязательно: low, medium, high. По умолчанию: high.
`output_format`	Необязательно: png, jpeg, webp. По умолчанию: png.
`images`	Необязательный массив из не более чем 16 HTTP(S)-адресов изображений. Один или несколько образцов включают редактирование; для генерации по тексту не передавайте это поле.

Проверьте задачу

GET /api/status

Задайте TASK_ID равным полученному data.task_id. Передайте его в параметре запроса task_id с тем же пользовательским ключом API.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: Задача ещё выполняется. Повторите запрос к этому методу, чтобы проверить её состояние.
SUCCESS: Адреса созданных изображений находятся в массиве data.response.
FAILED: Прочитайте подробности в data.error_message, прежде чем решать, отправлять ли новый запрос.

Пример завершённой задачи

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

Значения в угловых скобках обозначают идентификатор задачи и адрес изображения, полученные в вашем запросе.