gpt-image-1 API: гайд по подключению — цены и примеры (2026)

Если вам нужна функция «ввёл текст — получил картинку», то gpt-image-1 сейчас самая надёжная модель по следованию инструкциям и отрисовке текста внутри изображения. Ниже — как запустить её через OpenAI-совместимый эндпоинт GetModel: достаточно указать base_url как https://getmodel.ai/v1, и тот же ключ вызывает Claude, GPT и Gemini. Новым аккаунтам даются бесплатные кредиты, так что сначала можно попробовать gpt-image-1 бесплатно.

Что такое gpt-image-1

gpt-image-1 — нативно мультимодальная модель генерации изображений от OpenAI, вызывается через эндпоинт /v1/images/generations. По сравнению с предыдущей DALL·E 3 её сильные стороны:

• Точнее следует инструкциям — несколько объектов, композиция и взаимное расположение получаются ближе к запросу;
• Чётче текст внутри изображения — надписи на постерах, в UI и логотипах больше не превращаются в кашу;
• Image-to-image и локальная перерисовка — передайте референс и маску в эндпоинт images.edit.

Актуальные цены и доступность смотрите на странице модели-преемника gpt-image-2.

⏳ Актуальность (2026): gpt-image-1 планируется отключить 2026-12-01 в OpenAI API; рекомендуемая замена — gpt-image-2. Плюс агрегирующего эндпоинта GetModel: когда наступит этот день, достаточно поменять model с gpt-image-1 на gpt-image-2 — без изменений в авторизации, SDK и структуре запроса.

Быстрый старт: как использовать gpt-image-1

Сначала создайте API-ключ на странице «API-токены» в консоли GetModel (вида sk-...). Эндпоинт всегда https://getmodel.ai/v1.

⚠️ Важно: gpt-image-1 возвращает только base64 (b64_json), но не URL изображения. Не читайте data[0].url — там пусто.

Python

from openai import OpenAI
import base64

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://getmodel.ai/v1",
)

resp = client.images.generate(
    model="gpt-image-1",
    prompt="Сиба-ину в шлеме космонавта парит в космосе, плоская иллюстрация",
    size="1024x1024",   # или 1536x1024 альбом / 1024x1536 портрет
    quality="high",      # low | medium | high
    n=1,
)

img_b64 = resp.data[0].b64_json
with open("dog.png", "wb") as f:
    f.write(base64.b64decode(img_b64))

Node.js

import OpenAI from 'openai';
import { writeFileSync } from 'node:fs';

const client = new OpenAI({
  apiKey: 'sk-your-key',
  baseURL: 'https://getmodel.ai/v1',
});

const resp = await client.images.generate({
  model: 'gpt-image-1',
  prompt: 'A neon cyberpunk street in the rain, cinematic lighting',
  size: '1536x1024',
  quality: 'medium',
});

const b64 = resp.data[0].b64_json!;
writeFileSync('city.png', Buffer.from(b64, 'base64'));

cURL

curl https://getmodel.ai/v1/images/generations \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "Крупный план латте с рисунком на пене, тёплые тона, съёмка сверху под 45°",
    "size": "1024x1024",
    "quality": "high"
  }'

В возвращённом JSON изображение лежит в data[0].b64_json; декодируйте base64 и запишите в файл.

Основные параметры

Параметр	Значения	Описание
size	1024x1024 / 1536x1024 / 1024x1536	Квадрат / альбом / портрет — одно из трёх
quality	low / medium / high	Выше — медленнее и дороже; по умолчанию high
n	целое	Сколько изображений за вызов
output_format	png / jpeg / webp	Формат вывода, по умолчанию png
background	transparent / opaque / auto	Прозрачность требует png/webp
moderation	auto / low	Строгость модерации; low мягче

Цены: разбор официальной стоимости

gpt-image-1 тарифицируется по токенам — сгенерированные изображения считаются как «токены вывода изображений». Официальные ставки:

Тип	Цена (за 1 млн токенов)
Ввод текста	$5.00 (кэш $1.25)
Ввод изображений	$10.00 (кэш $2.50)
Вывод изображений	$40.00

В пересчёте «на одно изображение» нагляднее:

Качество	Квадрат 1024×1024	Альбом/портрет 1536×1024
low	$0.011	$0.016
medium	$0.042	$0.063
high	$0.167	$0.25

То есть пакетная генерация черновиков низкого качества — около 1 цента за штуку, а финальные в высоком качестве — около 17 центов. GetModel транслирует официальные ставки без наценки, баланс общий для всех моделей, а расход по каждому запросу детализирован на странице «Логи» в консоли. Актуальные цены и сравнение — на странице тарифов.

Разбор частых ошибок

Симптом	Причина и решение
401 invalid_api_key	Неверный ключ или отсутствует Authorization: Bearer sk-...
400 про size/quality	size — одно из трёх значений; quality — только low/medium/high
content_policy_violation	Промпт не прошёл модерацию — переформулируйте или добавьте "moderation": "low"
Пришло пустое изображение	Не читайте data[0].url — у gpt-image-1 есть только data[0].b64_json
429 лимит запросов	Сработал rate limit — добавьте экспоненциальный backoff; на стороне шлюза уже настроен failover по нескольким каналам
Тайм-аут запроса	Качество high медленное — поднимите client timeout выше 120 с

FAQ

• Есть ли image-to-image / перерисовка области? Да. Используйте client.images.edit(), передав image (исходник), опциональную mask (прозрачные зоны перерисуются) и prompt.
• Можно ли получить прозрачный фон? Да. Задайте background="transparent" и установите output_format в png или webp.
• Можно ли получить URL напрямую? Нет. gpt-image-1 всегда возвращает base64 — загрузите его в своё объектное хранилище, если нужна ссылка.
• Чем это отличается от прямого вызова OpenAI? Способ вызова, параметры и правила тарификации идентичны (OpenAI-совместимо). Разница лишь в том, что один ключ покрывает Claude / GPT / Gemini / gpt-image-1 с общим балансом и бесплатными кредитами на старте.
• Как получить бесплатные кредиты? Они начисляются при регистрации — войдите в консоль, посмотрите баланс и создайте ключ, а пополняйте уже после проверки.

---

Готовы? Создайте API-ключ и начните генерацию — просто замените sk-your-key в любом примере выше на свой.