Александр
AI

Как подключить GPT Image API из России. Фото с прозрачным фоном и 4K

Как подключить GPT Image API из России. Фото с прозрачным фоном и 4K

GPT Image 2.5, 2 и 1.5 работают по API под одним ключом CyHUB, оплата в рублях. Версия 2.5 отдаёт PNG с прозрачным фоном и картинки до 4K. На путеводителе с подписями она в моих прогонах не сделала ни одной опечатки, а Nano Banana на том же шаблоне путала буквы.

Первая картинка одним запросом

Сначала подтверждаете почту, затем в кабинете CyHUB на вкладке «Ключи доступа» выпускаете ключ. Скриншоты всех шагов, от входа до пополнения, собраны в гайде по API.

Модель в запросе называется images_chatgpt, а версия задаётся полем model уже внутри settings. Два поля с одним именем на разных уровнях - вот первое, на чём спотыкаются.

curl -X POST "https://api.cyhub.ai/v1/tasks" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ --data '{ "model": "images_chatgpt", "settings": { "model": "gpt-image-2-5-sunburst", "prompt": "Уютная кофейня дождливым вечером, тёплый свет в окнах", "aspect_ratio": "1:1", "resolution": "2K" } }'

Сервер сразу отвечает идентификатором задачи. Дальше опрашиваете её по этому id, пока в status не появится succeeded, и забираете PNG по download_path тем же ключом. За запуск выходит одна картинка, лежит она неделю. В 4K генерация идёт заметно дольше, до нескольких минут, так что таймаут берите с запасом.

Писать клиент с нуля же незачем. ИИ-агенту в Cursor, Claude Code или Codex хватит одного адреса, api.cyhub.ai/models/gpt-image-2-5/api.md: это страница модели в Markdown, с полями всех версий и примерами на cURL, Python и JavaScript.

Flare, Sunburst, 2 или 1.5

Как подключить GPT Image API из России. Фото с прозрачным фоном и 4K

• gpt-image-2-5-flare и gpt-image-2-5-sunburst - два варианта 2.5 с одинаковыми настройками: до 4K, три ступени качества, прозрачный фон, до 16 референсов. Описание обязательно даже с референсами. Подписи я делал на Sunburst.

• gpt-image-2 - шесть пропорций, до 4K, до 14 референсов. Картинку можно собрать по одним образцам, без описания.

• gpt-image-1.5 - три пропорции и одно разрешение, тоже до 14 референсов и тоже можно без описания.

Лимит описания у версий разный: у 2.5 до 20 000 знаков, у 2 и 1.5 до 3000. Длинное техзадание с текстом для инфографики влезет только в 2.5.

Качество, разрешение и пропорции

В 2.5 три поля работают в связке. quality - high, xhigh или max: каждая ступень дороже и считается дольше. resolution - 1K, 2K или 4K. aspect_ratio - двенадцать пропорций от 1:1 до 21:9, а на high есть ещё auto.

Связка ограничивает выбор: на high пропорции 27:16, 16:27, 9:8 и 8:9 доступны только в 1K. Подбирать сочетание на глазок не нужно. Перед пачкой запусков сверьте его через POST /v1/price: он считает цену и ничего не списывает.

Прозрачный фон

Поле background принимает auto, transparent или opaque. С transparent приходит PNG с альфа-каналом: наклейки, иконки, предметы для карточек товаров.

{ "model": "images_chatgpt", "settings": { "model": "gpt-image-2-5-flare", "prompt": "Рыжий кот в очках, вырезать предмет, фон прозрачный", "aspect_ratio": "1:1", "resolution": "1K", "background": "transparent" } }

В примере из документации прозрачность продублирована и в описании: «вырезать предмет, фон прозрачный». Прозрачный фон сочетается и с 4K, и с качеством max, такую связку я проверил расчётом цены. Только цена с прозрачным фоном считается иначе и зависит ещё от числа референсов.

Текст на картинке

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

{ "model": "images_chatgpt", "settings": { "model": "gpt-image-2-5-sunburst", "prompt": "Постер кофейни. Сверху крупно надпись \"Второй капучино за полцены\", ниже мелко \"по будням до 10 утра\". Другого текста нет.", "aspect_ratio": "2:3", "resolution": "2K", "quality": "xhigh" } }

Мелкий текст и плотную инфографику OpenAI же советует сравнивать на разных ступенях качества. Начинайте с xhigh и поднимайте до max, если мелкие подписи поплыли. Готовую картинку всё равно проверяйте глазами: орфографию ведь модель не гарантирует.

Референсы

В image_urls помещается до 16 образцов: JPEG, PNG или WebP, каждый не тяжелее 10 МБ. Сервер скачивает их сам, поэтому годится только открытая ссылка на файл, а не на страницу просмотра. Файл лежит у вас на диске - отправьте его в POST /v1/files, в ответе придёт адрес для image_urls. Картинку прошлой генерации для доработки возвращают в запрос тем же путём.

Что ломается

• 422 unknown_setting - в settings поле, которого у версии нет. Скажем, background или quality рядом с gpt-image-2: это настройки только 2.5.

• Запрос без описания - у 2.5 prompt обязателен всегда, даже с референсами.

• Референс не скачался - ссылка ведёт на страницу просмотра или требует входа. Нужна прямая ссылка на файл.

Картинки без кода, прямо в чате

Кому код не нужен, тому подойдёт плагин MCP: с ним GPT Image рисует прямо в диалоге с Claude или ChatGPT. Плагин входит через сайт, без ключа, и платит из того же кошелька кабинета. Подключение описано отдельно: для ChatGPT и для Claude.

Частые вопросы

Нужен ли аккаунт OpenAI? Нет. Запросы к GPT Image идут через ключ CyHUB, свой аккаунт и оплата OpenAI не нужны.

Можно ли получить сразу несколько картинок? Один запуск - одна картинка. Нужно четыре варианта - ставьте четыре задачи. Только одновременных задач у одной модели ограниченное число: на лишнюю придёт 429 too_many_active, её надо поставить чуть позже.

Спишутся ли деньги за неудачную генерацию? Нет. Пока задача идёт, сумма лишь заморожена. Завершилась ошибкой - заморозка снимается, и деньги остаются на балансе.

Страницы GPT Image 2, 1.5 и соседних моделей для картинок открываются из каталога CyHUB. А вам картинки по API нужны для чего: карточки товаров, обложки, иллюстрации в своём сервисе?

#нейросети #api #gptimage