Как использовать GPT Image 2.5 через API: гайд с примерами

curl -X POST "https://api.vega.chat/api/v1/images" \
  -H "Authorization: Bearer $VEGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-flare",
    "prompt": "Красная панда-астронавт парит в открытом космосе, студийное освещение",
    "aspect_ratio": "1:1",
    "quality": "medium"
  }'

{
  "created": 1788916400,
  "data": [
    {
      "b64_json": "<base64-картинки>",
      "media_type": "image/png"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 4175,
    "total_tokens": 4199,
    "cost": 0.04
  }
}

import base64

with open("panda.png", "wb") as f:
    f.write(base64.b64decode(result["data"][0]["b64_json"]))

{
  "model": "openai/gpt-image-2.5-sunburst",
  "prompt": "Создай оригинальный логотип для локальной пекарни «Поле и мука» (Field & Flour). Тёплый, простой, вне времени. Чистые векторные формы, сильный силуэт, сбалансированное негативное пространство. Плоский дизайн, минимум линий, без градиентов. Полностью прозрачный фон, один логотип по центру с большими полями, чистые края по альфа-каналу, без шахматного фона и водяных знаков.",
  "aspect_ratio": "1:1",
  "quality": "medium",
  "background": "transparent",
  "output_format": "png",
  "n": 4
}

import base64
import requests

response = requests.post(
    "https://api.vega.chat/api/v1/images",
    headers={
        "Authorization": "Bearer <VEGA_API_KEY>",
        "Content-Type": "application/json",
    },
    json={
        "model": "openai/gpt-image-2.5-flare",
        "prompt": "Фотореалистичный снимок пожилого моряка на рыбацкой лодке. "
                  "Он спокойно чинит сеть, рядом на палубе сидит пёс. "
                  "Как на 35-мм плёнку, средний план, объектив 50 мм, "
                  "мягкий прибрежный свет, лёгкое зерно, естественные цвета. "
                  "Без гламура и тяжёлой ретуши.",
        "aspect_ratio": "2:3",
        "quality": "medium",
    },
)

result = response.json()
for i, image in enumerate(result["data"], start=1):
    with open(f"sailor-{i}.png", "wb") as f:
        f.write(base64.b64decode(image["b64_json"]))

const response = await fetch('https://api.vega.chat/api/v1/images', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VEGA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-image-2.5-flare',
    prompt: 'UI-мокап мобильного приложения фермерского рынка: ' +
      'шапка, список продавцов с фото и категориями, блок «Сегодняшние скидки», ' +
      'адрес и часы работы. Белый фон, спокойные природные акценты, ' +
      'аккуратная типографика, минимум декора. Мокап внутри рамки iPhone.',
    aspect_ratio: '2:3',
    quality: 'medium',
  }),
});

const result = await response.json();
const image = result.data[0];
// image.b64_json это base64-картинка, image.media_type её формат
require('fs').writeFileSync('market-ui.png', Buffer.from(image.b64_json, 'base64'));

from openai import OpenAI

client = OpenAI(
    base_url="https://api.vega.chat/api/v1",
    api_key="<VEGA_API_KEY>",
)

result = client.images.generate(
    model="openai/gpt-image-2.5-sunburst",
    prompt="Праздничная открытка: старый плюшевый мишка сидит в коробке "
           "у окна, за окном падает снег. Тёплая ностальгическая сцена, "
           "мягкий кинематографичный свет, реалистичные текстуры, "
           "малая глубина резкости. Текст на открытке дословно: "
           "\"С Рождеством: некоторые воспоминания не исчезают.\"",
    size="1024x1536",
    quality="medium",
)

response = requests.post(
    "https://api.vega.chat/api/v1/images",
    headers={
        "Authorization": "Bearer <VEGA_API_KEY>",
        "Content-Type": "application/json",
    },
    json={
        "model": "openai/gpt-image-2.5-sunburst",
        "prompt": "Замени ТОЛЬКО белые стулья на деревянные. "
                  "Сохрани ракурс камеры, освещение комнаты, тени на полу "
                  "и окружающие предметы. Фотореалистичные контактные тени "
                  "и текстура дерева.",
        "input_references": [
            {
                "type": "image_url",
                "image_url": {"url": "https://example.com/kitchen.jpg"},
            }
        ],
        "quality": "medium",
    },
)

import base64

with open("photo.jpg", "rb") as f:
    data_url = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()

payload = {
    "model": "openai/gpt-image-2.5-sunburst",
    "prompt": "Убери цветок из руки мужчины. Больше ничего не меняй.",
    "input_references": [
        {"type": "image_url", "image_url": {"url": data_url}}
    ],
}

Вырежи товар со входного изображения и изолируй его на полностью
прозрачном фоне.
На выходе: товар по центру, чёткий силуэт, без ореолов и каймы.
Сохрани геометрию товара и читаемость этикетки один в один.
Только лёгкая чистка. Не добавляй сплошной фон, шахматку, декорации
и тени. Не переоформляй товар.

curl -N -X POST "https://api.vega.chat/api/v1/images" \
  -H "Authorization: Bearer $VEGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-flare",
    "prompt": "Детализированный пейзаж в стиле акварели",
    "stream": true
  }'

Текст на билборде (ДОСЛОВНО, без лишних символов):
"Свежесть и чистота"
Типографика: жирный гротеск, высокий контраст, по центру.
Текст должен появиться ровно один раз и идеально читаться.
Без водяных знаков и логотипов.

Создай подробную инфографику о работе автоматической кофемашины
вроде Jura. От контейнера для зёрен к помолу, весам, резервуару
для воды, бойлеру и так далее. Хочу понять весь процесс технически
и визуально.

Сделай модный рекламный кадр для уличного бренда Thread.
Это молодой дерзкий стритвир-бренд. В кадре компания друзей
тусуется вместе, слоган "Yours to Create.".
Кадр как готовая рекламная кампания для молодёжной аудитории:
стильно, современно, энергично, со вкусом.
Чистая композиция, сильная работа с цветом, естественные позы,
приёмы премиальной fashion-фотографии.
Слоган ровно один раз, чётко и читаемо, вписан в макет.
Без лишнего текста, водяных знаков и посторонних логотипов.

Создай короткий вертикальный комикс из 4 панелей.
Панель 1: хозяин выходит через входную дверь. Питомец в окне за его
спиной, маленький на фоне стекла, глаза широко раскрыты.
Панель 2: дверь закрывается. Питомец медленно поворачивается к пустому
дому, взгляд полный возможностей.
Панель 3: дом преображён. Питомец развалился на диване как хозяин,
рядом крошки, солнце режет комнату как прожектор.
Панель 4: дверь открывается. Питомец сидит у входа, собранный
и невозмутимый, как будто ничего не было.

Создай один слайд питч-дека с заголовком "Market Opportunity"
в стиле настоящего слайда серии A от стартапа из YC.
Чистый белый фон, современная гротеск-типографика вроде Inter,
минималистичная вёрстка. На слайде должны быть:
- Диаграмма TAM/SAM/SOM из концентрических кругов в приглушённых
  синих и серых тонах
- Правдоподобные цифры: TAM: $42B, SAM: $8.7B, SOM: $340M
- Столбчатый график роста рынка с 2021 по 2026 с лёгким восходящим
  трендом
- Мелкие сноски: "AGI Research, 2024" и "Internal analysis"
- Плейсхолдер логотипа в правом нижнем углу
Текст читаемый, данные с чёткой иерархией, аккуратные отступы.
Без клипарта, стоковых фото, градиентов и теней.

Создай иллюстрацию для детской книги, представляющую главного героя.

Персонаж:
юный герой в книжном стиле, похожий на маленького лесного разбойника,
в простой зелёной тунике с капюшоном, мягких коричневых сапогах
и с небольшим поясным мешочком. Доброе выражение лица, мягкие глаза,
смелый и тёплый характер. Держит маленький деревянный лук, которым
только помогает, но никому не вредит.

Тема:
персонаж защищает и спасает лесных зверей: белок, птиц, кроликов.

Стиль:
иллюстрация для детской книги, ручная акварель, мягкие контуры,
тёплые земляные цвета, сказочно и дружелюбно. Пропорции как в книжках
с картинками: чуть увеличенная голова, выразительное лицо.

Ограничения:
- оригинальный персонаж, без чужих героев
- без текста и водяных знаков
- простой лесной фон, чтобы персонаж читался

Продолжи историю для детской книги с тем же персонажем.

Сцена:
тот же юный лесной герой бережно помогает напуганной белке выбраться
из упавшего дерева после зимней бури. Персонаж стоит на коленях рядом
с белкой и успокаивает её.

Консистентность персонажа:
- та же зелёная туника с капюшоном
- те же черты лица, пропорции и цветовая палитра
- тот же мягкий и героический характер

Стиль:
акварельная иллюстрация для детской книги, мягкий свет, заснеженный
лес, тёплое и уютное настроение.

Ограничения:
- не перерисовывай персонажа заново
- без текста и водяных знаков

curl "https://api.vega.chat/api/v1/images/models" \
  -H "Authorization: Bearer $VEGA_API_KEY"

curl "https://api.vega.chat/api/v1/images/models/openai/gpt-image-2.5-flare/endpoints" \
  -H "Authorization: Bearer $VEGA_API_KEY"