Руководство по GPT-Image-2 API

GPT-Image-2 — API генерации изображений OpenAI

Получайте доступ к новейшей model генерации изображений OpenAI через унифицированный API TokenHub. Полная совместимость с OpenAI: синхронный ответ (без polling), несколько размеров до 4K, уровни качества и форматы вывода PNG/JPEG/WebP. Поддерживаются как text-to-image (t2i), так и image-to-image editing (i2i, композиция из нескольких изображений и inpainting). Это руководство проведёт вас через полную интеграцию.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1Получите свой API Key

Перейдите на tokenhub.store чтобы создать аккаунт (поддерживается вход через GitHub / Google)
Откройте Dashboard → API Keys и нажмите "Create New Key"
Откройте Dashboard → Billing, чтобы добавить Credits (1 Credit = $1 USD)
Скопируйте ваш API Key (формат: th-xxxxxxxxxxxx...)

⚠️ API Key показывается только один раз при создании. Сохраните его надёжно. Если вы его потеряете, нужно будет создать новый.

2Обзор API

Base URL

https://tokenhub.store/api/v1

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

Для всех запросов в заголовке требуется API Key:

Header

Authorization: Bearer th-your-api-key

Endpoints (Synchronous, OpenAI-compatible)

POST

/images/generations

Text-to-image. Генерация изображений по текстовому запросу.

POST

/images/edits

Image-to-image editing. Поддерживает редактирование одного изображения, композицию из нескольких изображений и опциональный inpainting с маской.

3Цены

Tier	Цена	Диапазон разрешений
1K	$0.125 / image	Длина большей стороны ≤ 1536 px (например, 1024×1024, 1024×1536)
2K	$0.250 / image	Длина большей стороны ≤ 2048 px (например, 2048×2048)
4K	$0.500 / image	Самая длинная сторона > 2048 px (например, 4096×4096)

Фиксированная цена за каждое изображение в зависимости от уровня выходного разрешения (определяется по самой длинной стороне размера). n изображений = цена за единицу × n. Неудачные запросы не тарифицируются.

Соответствие уровней по самой длинной стороне: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Примеры: 1024×1024 и 1024×1536 — это 1K; 2048×2048 — 2K; 4096×4096 — 4K.

4Параметры запроса

Параметр	Тип	Обязательный	По умолчанию	Описание
model	string	Обязательный	—	ID model. Используйте "openai/gpt-image-2" (или короткую форму "gpt-image-2").
prompt	string	Обязательный	—	Текстовый prompt с описанием изображения для генерации.
n	integer	Необязательный	1	Количество изображений для генерации (1–10).
size	string	Необязательный	1024x1024	Размер выходного изображения. Варианты: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Необязательный	auto	Качество генерации. Варианты: auto, low, medium, high. Более высокое качество потребляет больше Tokens.
format	string	Необязательный	png	Формат выходного изображения. Варианты: png, jpeg, webp.

Дополнительные поля для /images/edits (i2i)

Параметр	Тип	Обязательный	По умолчанию	Описание
image	file / string \| array	Обязательный	—	Входное изображение(я) для редактирования. Принимает файл(ы) через multipart или URL / base64 data URI в JSON. Укажите несколько изображений, чтобы объединить их в один результат.
mask	file / string	Необязательный	—	Необязательная маска для inpainting. Прозрачные области будут сгенерированы заново; непрозрачные области сохраняются.
input_fidelity	string	Необязательный	low	Насколько точно сохранять входное изображение. Варианты: low, high. Используйте high, чтобы сохранить идентичность/макет; low — для более смелых преобразований.
output_format	string	Необязательный	png	Псевдоним 'format' для endpoint редактирования. Варианты: png, jpeg, webp.
output_compression	integer	Необязательный	100	Уровень сжатия 0–100 (только для jpeg / webp).

5Полный пример curl

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

Ответ:

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Полный пример на Python

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7Полный пример на JavaScript / Node.js

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8Советы по использованию

Запросы на английском обычно дают лучшие результаты; китайский тоже поддерживается.
Response data[].url может быть обычным https URL или data URI (base64). При сохранении на диск обработайте оба варианта.
Чтобы снизить стоимость, используйте low/medium для черновиков и только high/размеры 4K для финального результата.
Endpoint синхронный — без task id и без polling. Запрос обычно выполняется за 5–30 секунд в зависимости от размера и качества.
Установите HTTP timeout на стороне клиента на ≥ 120s, чтобы избежать преждевременного разрыва соединения на больших изображениях.

9FAQ

Готовы начать?

Зарегистрируйтесь в TokenHub и начните использовать GPT-Image-2 API прямо сейчас

Получить API Key Пополнить Credits