GPT Image 2.5 Sunburst · API

Аутентификация

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Чтобы начать, создайте API-ключ в консоли.

Тело запроса

Пример запроса

# 1) submit -> 202 {"id":"img_...","status":"queued"}
curl https://nezhagate.com/v1/images/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "gpt-image-2.5-sunburst", "prompt": "a serene ink-wash poster, lots of negative space", "size": "1024x1536"}'
# 2) poll until status=succeeded
curl https://nezhagate.com/v1/images/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

import time, requests

base, key = "https://nezhagate.com/v1", "YOUR_API_KEY"
h = {"Authorization": f"Bearer {key}"}
job = requests.post(f"{base}/images/generations", headers=h,
                    json={"model": "gpt-image-2.5-sunburst", "prompt": "an ink-wash poster", "size": "1024x1536"}).json()
while True:
    r = requests.get(f"{base}/images/jobs/{job['id']}", headers=h).json()
    if r["status"] in ("succeeded", "failed"): break
    time.sleep(3)
print(r.get("data", [{}])[0].get("url"))

const base = "https://nezhagate.com/v1", key = "YOUR_API_KEY";
const h = { Authorization: `Bearer ${key}`, "Content-Type": "application/json" };
const job = await (await fetch(`${base}/images/generations`, { method: "POST", headers: h,
  body: JSON.stringify({ model: "gpt-image-2.5-sunburst", prompt: "an ink-wash poster", size: "1024x1536" }) })).json();
let r;
do { await new Promise(s => setTimeout(s, 3000));
     r = await (await fetch(`${base}/images/jobs/${job.id}`, { headers: h })).json();
} while (r.status !== "succeeded" && r.status !== "failed");
console.log(r.data?.[0]?.url);

Ответ

{
  "id": "img_3f9a...c2",
  "object": "image.generation.job",
  "status": "queued",
  "model": "gpt-image-2.5-sunburst"
}

Редактирование изображений (по изображению)

Редактирование изображений (по изображению): укажите референс в поле `image` (публичный URL, data: URI или base64), чтобы получить настоящий i2i с сохранением идентичности — модель перегенерирует изображение с учётом выбранного размера и соотношения сторон. Эквивалентно вызову /v1/images/edits.

curl https://nezhagate.com/v1/images/generations -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "gpt-image-2.5-sunburst", "prompt": "замените фон на звёздное небо", "image": "https://example.com/ref.png", "size": "3:4"}'

Задачи генерации изображений (отправка → опрос результата)

Рендеринг изображения обычно занимает 1–3 минуты, поэтому эндпоинты изображений работают только через задачи: отправка запроса сразу возвращает job id (HTTP 202); по этому id нужно опрашивать результат — сервер продолжает рендеринг даже при перезапуске, так что изображение никогда не теряется. То же самое для text-to-image и image-to-image. (Старое поле "async": true больше не нужно; оно принимается, но игнорируется.)

curl https://nezhagate.com/v1/images/generations -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"model": "gpt-image-2.5-sunburst", "prompt": "постер в стиле живописи тушью с большим количеством пустого пространства", "size": "3:4"}'

{ "id": "img_3f9a...c2", "object": "image.generation.job", "status": "queued", "model": "gpt-image-2.5-sunburst" }

curl https://nezhagate.com/v1/images/jobs/img_3f9a...c2 -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "img_3f9a...c2",
  "object": "image.generation.job",
  "status": "succeeded",
  "model": "gpt-image-2.5-sunburst",
  "data": [{ "url": "https://img.nezhagate.com/i/9f86d081a8....png" }]
}

🕑 data[0].url — это ссылка на наш хостинг изображений; она хранится 60 дней, а затем автоматически удаляется. Чтобы продолжать использовать изображение, скачайте его и сохраните в своём хранилище или CDN.

status принимает одно из значений: queued / processing / succeeded / failed. При успехе ответ содержит data[].url. Опрашивать задачу может только аккаунт, который её создал. Эндпоинты изображений всегда асинхронны — отправка возвращает job id; поле "async": true принимается только для обратной совместимости и игнорируется.

Коды ошибок

Каждое тело ошибки содержит error.message / error.type / error.code / error.param — ветвите логику по code; полный список — в руководстве по интеграции.