gpt-image-2: генерация и редактирование изображений

OpenAI-совместимое API gpt-image-2 для генерации изображений из текста и редактирования: переключите base_url и используйте, мульти-регион, единый биллинг через QCode-ключ

title: "gpt-image-2: генерация и редактирование изображений" description: "OpenAI-совместимое API gpt-image-2 для генерации изображений из текста и редактирования: переключите base_url и используйте, мульти-регион, единый биллинг через QCode-ключ"

gpt-image-2: генерация и редактирование изображений¶

QCode.cc предоставляет полностью OpenAI-совместимое API gpt-image-2, охватывающее две эндпоинты:

• Text-to-image POST /v1/images/generations — JSON-запрос, генерация изображения из текста
• Редактирование изображения POST /v1/images/edits — multipart-загрузка 1–8 исходных изображений (опциональная маска), перерисовка / правка / композиция по prompt (запущено в мае 2026)

gpt-image-2 — это новейшая модель text-to-image от OpenAI (выпущена в апреле 2026 года) с сильнейшим на сегодня рендерингом текста внутри изображения среди публичных моделей (стабильно отрисовывает английские и китайские символы внутри картинки).

Что добавляет QCode.cc:

• Drop-in для OpenAI SDK — меняется только base_url; форматы запроса и ответа на 100% идентичны (включая multipart-эндпоинт edits)
• Мульти-регион: HK / Япония / США / Европа / прямое подключение Шэньчжэня — выбирайте ближайший узел
• Единый API-ключ: используется ваш существующий ключ QCode.cc (cr_…) — общая квота с Claude Code, Codex и Gemini CLI
• Единый просмотр использования: вызовы изображений и чата объединены в дашборде клиента + отдельная страница самообслуживания
• Квоты делятся между эндпоинтами: generations и edits используют общий лимит 100 изображений/день/ключ и 2 параллельных запроса

Типичные сценарии: постеры, иллюстрации, изображения товаров, UI-моки, материалы для соцсетей, редактирование изображений (локальная перерисовка / композиция нескольких изображений / смена фона / высокоточная реставрация).

Быстрый старт¶

Text-to-image (generations)¶

Три строки Python для первого изображения:

from openai import OpenAI
import base64

client = OpenAI(
    base_url="https://api.qcode.cc/qcode-img/v1",
    api_key="cr_YOUR_QCODE_API_KEY",
    timeout=180.0,  # 30–120 с на изображение, задайте ≥ 180 с
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="A cyberpunk Tokyo street at night, neon reflecting in rain puddles",
    size="1024x1024",
    quality="low",
    n=1,
)

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

Редактирование (edits)¶

Загрузите существующее изображение + prompt, опционально маску для локальной перерисовки:

from openai import OpenAI
import base64

client = OpenAI(
    base_url="https://api.qcode.cc/qcode-img/v1",
    api_key="cr_YOUR_QCODE_API_KEY",
    timeout=180.0,
)

result = client.images.edit(
    model="gpt-image-2",
    image=open("cat.png", "rb"),
    mask=open("mask.png", "rb"),          # опционально: PNG alpha, прозрачная зона = область перерисовки
    prompt="put a tiny crown on the cat",
    size="1024x1024",
    quality="high",
    extra_body={"input_fidelity": "high"},  # высокая верность, сохраняет детали оригинала
)

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

⚠️ Обязательно задайте timeout ≥ 180 с явно: дефолтный timeout OpenAI SDK слишком короткий. Время инференса gpt-image-2 значительно больше, чем у классических text-to-image моделей (см. Время генерации и timeout ниже).

Точки входа¶

Сервис gpt-image-2 (generations + edits общие) доступен на всех доменах QCode.cc — просто добавьте /qcode-img/v1 к базе:

Все точки входа маршрутизируются в одну систему биллинга — использование и квоты унифицированы. Полное описание эндпоинтов: Эндпоинты и API-пути.

qcode-img — это префикс пути, выделенный для генерации и редактирования изображений; параллелен /api (Anthropic), /openai/v1 (OpenAI chat) и /gemini (Gemini).

API-справочник¶

Общие заголовки запроса¶

Эндпоинт generations /v1/images/generations¶

Эндпоинт: POST {base_url}/images/generations Content-Type: application/json

Тело запроса:

{
  "model": "gpt-image-2",
  "prompt": "A small ceramic vase with sunflower, photorealistic",
  "size": "1024x1024",
  "quality": "low",
  "n": 1
}

Поля:

Эндпоинт edits /v1/images/edits¶

Эндпоинт: POST {base_url}/images/edits Content-Type: multipart/form-data (загрузка файлов требует form-data, JSON не подходит)

Поля:

Лимиты загрузки: один файл ≤ 25 МБ; суммарно ≤ 200 МБ (превышение даёт 413 image_too_large).

Ответ (одинаков для обоих эндпоинтов)¶

{
  "created": 1777135432,
  "data": [
    {
      "b64_json": "iVBORw0KGgo...(base64 PNG/JPEG/WebP, 1-3 МБ)",
      "revised_prompt": "A small ceramic vase with sunflower..."
    }
  ]
}

• b64_json: base64-закодированные данные изображения, во фронте можно использовать напрямую: <img src="data:image/<format>;base64,...">
• revised_prompt: улучшенная моделью версия вашего prompt (опционально показать пользователю)

Ответы об ошибках¶

Ошибки следуют стандартной схеме OpenAI:

{
  "error": {
    "type": "rate_limit_error",
    "code": "image_daily_limit",
    "message": "Daily image generation count limit reached..."
  }
}

Примеры кода¶

Python (OpenAI SDK, рекомендуется)¶

Text-to-image:

from openai import OpenAI
import base64

client = OpenAI(
    base_url="https://api.qcode.cc/qcode-img/v1",
    api_key="cr_YOUR_QCODE_API_KEY",
    timeout=180.0,
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="A cyberpunk Tokyo street at night, neon reflecting in rain puddles",
    size="1024x1024",
    quality="low",
    n=1,
)

img_bytes = base64.b64decode(result.data[0].b64_json)
with open("output.png", "wb") as f:
    f.write(img_bytes)
print("Сохранено output.png")

Редактирование (одно изображение + mask, локальная перерисовка):

from openai import OpenAI
import base64

client = OpenAI(
    base_url="https://api.qcode.cc/qcode-img/v1",
    api_key="cr_YOUR_QCODE_API_KEY",
    timeout=180.0,
)

result = client.images.edit(
    model="gpt-image-2",
    image=open("cat.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="put a tiny crown on the cat",
    size="1024x1024",
    quality="high",
    extra_body={
        "input_fidelity": "high",
        "background": "transparent",
        "output_format": "png",
    },
)

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

Редактирование (композиция нескольких изображений, 2 – 8):

result = client.images.edit(
    model="gpt-image-2",
    image=[
        open("scene.png", "rb"),       # 1-е изображение: сцена-фон
        open("product.png", "rb"),     # 2-е изображение: товар для размещения
    ],
    prompt="Place the product naturally into the scene, match the lighting and shadows.",
    size="1536x1024",
    quality="high",
    extra_body={"input_fidelity": "high"},
)

curl¶

Text-to-image:

curl https://api.qcode.cc/qcode-img/v1/images/generations \
  -H "Authorization: Bearer cr_YOUR_QCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cyberpunk Tokyo street at night",
    "size": "1024x1024",
    "quality": "low",
    "n": 1
  }' \
  | jq -r ".data[0].b64_json" | base64 -d > output.png

Редактирование:

curl https://api.qcode.cc/qcode-img/v1/images/edits \
  -H "Authorization: Bearer cr_YOUR_QCODE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@cat.png" \
  -F "mask=@mask.png" \
  -F "prompt=put a tiny crown on the cat" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "input_fidelity=high" \
  -F "background=transparent" \
  -F "output_format=png" \
  | jq -r ".data[0].b64_json" | base64 -d > edited.png

Композиция нескольких изображений (просто повторите -F image=@):

curl https://api.qcode.cc/qcode-img/v1/images/edits \
  -H "Authorization: Bearer cr_YOUR_QCODE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@scene.png" \
  -F "image=@product.png" \
  -F "prompt=Place the product naturally into the scene" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "input_fidelity=high"

JavaScript / Node.js / браузер¶

Text-to-image:

const r = await fetch("https://api.qcode.cc/qcode-img/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer cr_YOUR_QCODE_API_KEY",
    "Content-Type":  "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "A cyberpunk Tokyo street at night",
    size: "1024x1024",
    quality: "low",
    n: 1,
  }),
});
const json = await r.json();
const dataUrl = "data:image/png;base64," + json.data[0].b64_json;
document.querySelector("img").src = dataUrl;

Редактирование (браузерный FormData):

const fd = new FormData();
fd.append("model", "gpt-image-2");
fd.append("image", imageFile);              // объект File из <input type="file">
fd.append("mask", maskFile);                // опционально
fd.append("prompt", "put a tiny crown on the cat");
fd.append("size", "1024x1024");
fd.append("quality", "high");
fd.append("input_fidelity", "high");
fd.append("background", "transparent");
fd.append("output_format", "png");

const r = await fetch("https://api.qcode.cc/qcode-img/v1/images/edits", {
  method: "POST",
  headers: { "Authorization": "Bearer cr_YOUR_QCODE_API_KEY" },
  // Не задавайте Content-Type вручную — FormData выставит multipart/form-data с boundary автоматически
  body: fd,
});
const json = await r.json();
const dataUrl = "data:image/png;base64," + json.data[0].b64_json;
document.querySelector("img").src = dataUrl;

Квоты¶

Лимиты по умолчанию¶

Дефолтных квот хватает большинству пользователей. Для повышения — свяжитесь со службой поддержки.

Просмотр использования¶

• Дашборд клиента: показывает чат и изображения вместе (последняя активность, сегодняшняя стоимость, накопленная стоимость, распределение по моделям)
• Страница самообслуживания: https://api.qcode.cc/qcode-img/usage — введите API-ключ, чтобы посмотреть статистику за последние 30 дней, детальный список вызовов и тренды на ECharts (ключ хранится только локально в браузере, не загружается)

Биллинг¶

Базовая цена (за изображение)¶

generations и edits используют одну ценовую таблицу:

Минимум $0.08 за вызов¶

• Когда фактическая стоимость < $0.08, тариф $0.08 (low / medium обычно упираются в этот floor)
• Когда фактическая стоимость ≥ $0.08, оплачивается реальная сумма (без накрутки)

Множественные выходы и multi-input edits¶

• n > 1 линейно масштабирует по выходному количеству. Пример: n=2 + 1024×1024 high = 2 × $0.211 = $0.422
• Для multi-input в edits (image=[…N]) биллинг по выходам (n), а не по входам
• mask не влияет на оплату

Сбои не тарифицируются¶

Любой 4xx / 5xx — не оплачивается; разрыв соединения клиентом тоже не оплачивается.

Валюта¶

Стоимости в USD, расчёт по валютной политике основного аккаунта QCode.cc (RMB / USD).

Время генерации и настройка timeout¶

gpt-image-2 — модель на основе инференса, значительно медленнее классических text-to-image (DALL·E 3 / SDXL):

Время edits сопоставимо с generations. Multi-input / высокое разрешение / input_fidelity=high могут смещать к верхней границе.

Практические рекомендации:

• Дефолтный timeout в OpenAI Python SDK слишком короткий — всегда задавайте timeout=180.0 или больше явно
• В браузере у fetch нет дефолтного timeout, но при использовании AbortController задайте минимум 180 с
• При использовании medium / high из материкового Китая рекомендуется asia.qcode.cc (прямое подключение, без CDN 100 с лимита)

100-секундный лимит CDN (ошибки 524)¶

HTTPS-запросы к api.qcode.cc / asia.qcode.cc / eu.qcode.cc / us.qcode.cc проходят через глобальный CDN (CloudFlare). CDN принудительно возвращает 524 для любого запроса, ждущего ответ origin более 100 секунд.

Меры (рекомендуется для medium / high):

1. Используйте qcode-img прямой вход: https://api.qcode.cc/qcode-img/v1 (без CDN, без 100-секундного лимита)
2. Или принимайте редкие 524 + клиентский ретрай

Советы по prompt¶

Text-to-image (generations)¶

• Многоязычно: китайский, английский, смешанные prompts работают
• Чем больше деталей, тем лучше: окружение, композиция, освещение, стиль, дистанция объектива / фокусное расстояние / ракурс
• Избегайте брендов и знаменитостей: модель может отказать или выдать размытый результат (политика контента OpenAI)
• Рендеринг текста внутри изображения: gpt-image-2 исключителен в рендеринге английских / китайских символов внутри изображений (заголовки постеров, слоганы, вывески) — просто запишите текст в prompt, специальный синтаксис не нужен

Пример:

A vintage poster in Bauhaus style, bold black text "MORNING COFFEE" centered,
warm orange and cream color palette, geometric shapes, slightly textured paper background

Редактирование (edits)¶

• Маска говорит "где", а не "что": прозрачная зона = область перерисовки, непрозрачная сохраняется. Prompt описывает, что нарисовать. Разрешение mask должно совпадать с image (система масштабирует).
• Для multi-input в prompt укажите роль каждого изображения — например "First image is the scene, second image is the product to place into it" — gpt-image-2 читает входы по порядку.
• input_fidelity=high сохраняет лица / логотипы / текст / детали товара — для портретов, бренд-ассетов, композиций товара в сцене. low для радикальных стилевых изменений.
• Без mask перерисовывается всё изображение по prompt (семантика сохраняется, но любая зона может измениться).

Пример:

# Локальная перерисовка + высокая верность: добавить корону, остальное без изменений
prompt = "Put a tiny golden crown on the cat's head. Keep everything else unchanged."
input_fidelity = "high"
mask = (alpha PNG только с прозрачной зоной головы)

Отличия от официального OpenAI API¶

Онлайн Playground¶

https://api.qcode.cc/qcode-img/ — попробуйте в браузере:

• Text-to-image и Image-edit оба режима — визуальные (загрузка, рисование mask, выбор input_fidelity / background / output_format и т. д.)
• Введите API-ключ + prompt и сразу генерируйте
• Переключение языка интерфейса (EN / 中文)
• По умолчанию low (избегает CDN 524)
• Включает полную API-документацию inline (вкладки curl / Python / JavaScript + таблица параметров + коды ошибок)
• Скачивание в один клик как PNG / JPEG / WebP

Связанные документы¶

• Эндпоинты и API-пути — все домены QCode.cc, пути протоколов, curl-проверка
• Биллинг — тарифы, квоты, правила тарификации