GPT Image 2 API через Flatkey следует начинать с проверки строки модели, а не с копирования блока кода. OpenAI документирует gpt-image-2 как текущую модель генерации изображений, а ценовой снимок Flatkey от 17 июня 2026 года перечисляет строки семейства GPT image. Практический вопрос для production-команды уже более узкий: к какой строке будет обращаться ваше приложение, какой формат endpoint открывает эта строка, какую единицу тарификации должна проверить финансовая команда и какие проверки запроса должны пройти, прежде чем трафик пойдет через router?
Это руководство проходит по этим проверкам для команд, которым нужен один ключ Flatkey, OpenAI-compatible base URL https://router.flatkey.ai/v1, журналы использования и проверка цен в одном месте. Рассматривайте каждый приведенный ниже пример кода как шаблон. В статье используются официальная документация OpenAI, датированный снимок каталога Flatkey и проверки CMS/public-route, но не утверждается, что был проведен live-тест инференса GPT Image 2 API в Flatkey.
Краткий ответ: что проверить перед использованием GPT Image 2 API через Flatkey
Если вы оцениваете GPT Image 2 API через Flatkey, проверьте эти пункты в таком порядке:
- Откройте тарифы Flatkey и найдите точную строку модели, например
gpt-image-2илиopenai/gpt-image-2. - Подтвердите поддерживаемый тип endpoint для этой строки. В снимке от 17 июня 2026 года основные строки
gpt-image-2показывалиopenai, тогда как более старые строки GPT image также показывалиimage-generation. - Проверьте статус доступности. В снимке строки GPT Image 2 показывали
unknown_failure, поэтому для использования в production нужен актуальный просмотр панели и небольшой smoke test. - Сравните единицы тарификации перед запуском. Flatkey показывал поля в стиле token-ratio для одной строки и поле
model_price, выглядевшее как цена за запрос, для другой строки, поэтому не стоит предполагать одну и ту же единицу для каждого маршрута GPT Image 2 API. - Сопоставьте тело запроса с подтвержденным маршрутом: стиль Images API, стиль Responses API или совместимая с OpenAI обертка, поддерживаемая Flatkey.
- Логируйте ID модели, путь endpoint, качество, размер вывода, формат вывода, количество входных изображений, число повторных попыток, usage и итоговую стоимость на один принятый asset.
Эта последовательность важна, потому что GPT Image 2 API — это не просто имя модели. Это сочетание ID модели, endpoint, параметров запроса, прав учетной записи, статуса маршрутизации и единицы биллинга.
Что OpenAI документирует для GPT Image 2 API
Руководство OpenAI по изображениям сообщает, что модели GPT Image могут использовать текстовые и графические входные данные для создания новых изображений или редактирования существующих, а gpt-image-2 описывается как современная модель генерации изображений с сильным следованием инструкциям и контекстной осведомлённостью. В руководстве также говорится, что команды могут создавать или редактировать изображения либо через Images API, либо через Responses API.
Для пути через Images API справочник по созданию изображений документирует POST /images/generations. В нём указаны параметры, важные для проверок производственных запросов: prompt, background, moderation, output_format, quality, size, stream и n. Также указано, что модели GPT image возвращают изображения, закодированные в base64, а не временные URL-адреса изображений.
| Проверка OpenAI | Почему это важно для Flatkey | Действие в production |
|---|---|---|
model |
Прямой идентификатор модели OpenAI может не совпадать со строкой в маршрутизируемой строке каталога. | Запишите точную строку Flatkey и строку модели в вашем запросе. |
POST /images/generations |
Это официальный путь генерации через Images API, но поддержка конечной точки Flatkey зависит от строки. | Используйте этот маршрут через Flatkey только после того, как панель управления покажет поддержку Images API для выбранной строки. |
background and output_format |
Прозрачный вывод требует совместимого формата, такого как PNG или WebP. | Проверяйте формат вывода перед созданием рабочих процессов дизайна, зависящих от alpha. |
quality and size |
Это основные рычаги стоимости и задержки для рабочих нагрузок GPT Image 2 API. | Разделяйте настройки draft, preview и final-render в логике продукта. |
| Обработка ответа Base64 | Модели GPT image возвращают байты изображения, а не долго живущие размещённые URL. | Храните изображение самостоятельно, прикрепляйте метаданные и не полагайтесь на URL провайдера. |
Снимок каталога Flatkey для GPT Image 2
17 июня 2026 года публичный API цен Flatkey вернул версию прайсинга a42d372ccf0b5dd13ecf71203521f9d2 и 638 строк моделей. Сводка по семейству изображений GPT включала gpt-image-2, openai/gpt-image-2, gpt-image-2-all, gpt-image-1.5, gpt-image-1-mini и gpt-image-1.
| Строка Flatkey | Группы | Типы эндпоинтов в снимке | Какие поля прайсинга были обнаружены | Статус в снимке | Как использовать это подтверждение |
|---|---|---|---|---|---|
gpt-image-2 |
Economy, Standard | openai |
model_ratio: 3.325, completion_ratio: 6, cache_ratio: 0.251127819549 |
unknown_failure |
Используйте только как датированное подтверждение из каталога; перед рабочим трафиком GPT Image 2 API проверьте текущий статус строки. |
openai/gpt-image-2 |
Standard | openai |
quota_type: 1, model_price: 0.063 |
unknown_failure |
Не копируйте число, не подтвердив текущую единицу измерения и метку в панели управления. |
gpt-image-2-all |
Standard | openai |
model_ratio: 37.5, completion_ratio: 2 |
unknown_failure |
Проверьте, является ли это пакетом, псевдонимом или внутренней строкой маршрутизации, прежде чем использовать в коде. |
gpt-image-1.5 and gpt-image-1-mini |
Standard | image-generation, openai |
Поля прайсинга в формате ratio | unknown_failure |
Полезные сравнительные строки, но не замена выбранной строке API GPT Image 2. |
На публичной странице прайсинга также доступны семейства эндпоинтов, такие как image-generation с путем /v1/images/generations, openai с путем /v1/chat/completions и openai-response с путем /v1/responses. Важная деталь заключается в том, что семейства эндпоинтов существуют на уровне платформы, тогда как поддержка по-прежнему зависит от конкретной строки. Для GPT Image 2 API перед написанием запроса обязательно подтвердите строку.
Проверки запроса для GPT Image 2 API
Используйте этот чеклист перед любым развертыванием маршрутизируемого GPT Image 2 API. Он намеренно ориентирован на операционные аспекты, потому что ошибки в ценообразовании обычно возникают из-за формы запроса, а не из-за непонимания одной заголовочной ставки.
| Проверка | Условие успеха | Режим сбоя | Где проверять |
|---|---|---|---|
| Строка модели | Строка в дашборде Flatkey совпадает со строкой модели в коде. | Приложение по ошибке вызывает устаревшую, псевдонимную или пакетную строку. | Тарифы и каталог моделей Flatkey. |
| Путь конечной точки | Путь маршрута соответствует поддерживаемому типу конечной точки строки. | Тело Images API отправляется в строку, совместимую с chat, или наоборот. | Поддержка строки Flatkey и справочник OpenAI API. |
| Доступность | Статус в дашборде чистый, и небольшой запрос выполняется успешно. | Строка в каталоге существует, но доступ к upstream или к учетной записи не удается. | Дашборд Flatkey, статус ответа и логи. |
| Единица ценообразования | Финансы знают, является ли строка token-ratio, request-priced или использует другую единицу. | Бюджет использует допущения per-token для строки с оплатой per-request. | Тарифы Flatkey и дашборд использования. |
| Параметры prompt и image input | Длина prompt, ссылки на изображения, маски и повторы логируются. | Входные изображения и повторы создают скрытую стоимость. | Телеметрия приложения и поля использования провайдера. |
| Параметры вывода | Quality, size, background, format и compression контролируются. | Каждый предпросмотр генерируется как финальный asset. | Тело запроса и значения по умолчанию продукта. |
Шаблон: прямой запрос к OpenAI Images API
Шаблон прямого обращения к провайдеру полезен как базовый ориентир при сравнении поведения маршрута Flatkey. Перед запуском подтвердите текущий доступ к аккаунту OpenAI и доступность модели.
# Template only: direct OpenAI Images API baseline
curl https://api.openai.com/v1/images/generations \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Create a clean product concept image for a usage dashboard.",
"size": "1536x1024",
"quality": "medium",
"output_format": "png"
}'
Для базового теста GPT Image 2 API оставьте первый запрос простым, не используйте референсные изображения, задайте один результат и зафиксируйте статус ответа, задержку, размер вывода и любые поля usage, возвращённые конечной точкой.
Шаблон: проверка маршрута Flatkey
Публичное позиционирование Flatkey строится вокруг одного ключа и base URL, совместимого с OpenAI. Для текстовых маршрутов на публичной главной странице указан https://router.flatkey.ai/v1/chat/completions. Для маршрутизации GPT Image 2 API не следует предполагать, что путь для изображений включен для выбранной строки. Сначала проверьте, отображает ли строка в вашей панели управления image-generation, openai, openai-response или другой маршрут.
# Шаблон только: используйте эту форму только если ваша строка Flatkey подтверждает поддержку image-generation
curl https://router.flatkey.ai/v1/images/generations \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Create a clean product concept image for a usage dashboard.",
"size": "1536x1024",
"quality": "medium",
"output_format": "png"
}'
// Шаблон только: централизуйте base URL, затем подставьте подтвержденный путь.
const FLATKEY_BASE_URL = "https://router.flatkey.ai/v1";
async function createImageThroughConfirmedRoute({ path, apiKey, body }) {
const response = await fetch(`${FLATKEY_BASE_URL}${path}`, {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json"
},
body: JSON.stringify(body)
});
if (!response.ok) {
throw new Error(`Проверка маршрута Flatkey не удалась: ${response.status}`);
}
return response.json();
}
// Пример только после подтверждения в панели управления:
await createImageThroughConfirmedRoute({
path: "/images/generations",
apiKey: process.env.FLATKEY_API_KEY,
body: {
model: "gpt-image-2",
prompt: "Create a clean product concept image for a usage dashboard.",
size: "1536x1024",
quality: "medium",
output_format: "png"
}
});
Если текущая строка Flatkey по-прежнему отображает только openai, уточните у продукта или поддержки, какая форма запроса поддерживается для этой строки GPT Image 2 API, прежде чем выпускать в продакшн. Для рабочей интеграции необходимы и строка каталога, и путь эндпоинта; одно без другого — это не production-интеграция.
Проверки ценообразования, которые нужно выполнить в Flatkey
Для этой статьи самый безопасный совет по ценообразованию — процедурный: проверьте текущую строку в Flatkey pricing, сравните её с актуальной страницей цен на изображения OpenAI, затем подтвердите фактическое маршрутизированное использование в логах. Снимок Flatkey от 17 июня подтверждает, что в каталоге были строки GPT image, но поля строк использовали разные представления цены. Этого достаточно, чтобы выстроить рабочий процесс проверки цен, но недостаточно, чтобы публиковать постоянное утверждение о цене.
| Pricing Question | What To Record | Why It Matters |
|---|---|---|
| Which row is selected? | Exact model name, group, quota type, and endpoint type. | Multiple GPT image-family rows can appear in the same catalog. |
| What unit is displayed? | Token ratio, request price, per-output unit, or dashboard-specific label. | Mixing units causes budget errors even when the model name is right. |
| What settings change cost? | Quality, size, prompt length, image inputs, output format, retries, and batch behavior. | The same GPT Image 2 API feature can have preview and final-render cost tiers. |
| What does Flatkey log? | Request count, status, usage, cost, model row, and failure reason. | Logs prove whether routed usage matches the estimate. |
Команды, сравнивающие бюджеты на изображения, также должны прочитать OpenAI Image API Pricing и AI Model Pricing Comparison. Эти материалы охватывают более широкую механику стоимости токенов, изображений и видео; эта страница сосредоточена на проверках маршрута GPT Image 2 API, специфичных для Flatkey.
План smoke-тестирования перед выходом в production-трафик
Запустите небольшой набор проверок после того, как подтверждены строка дашборда, endpoint и ценовая единица:
- Отправьте один прямой базовый запрос OpenAI, если у вашей команды есть прямой доступ к OpenAI.
- Отправьте один запрос Flatkey через подтвержденный endpoint и строку модели.
- Сравните форму ответа, формат вывода, байты вывода, сообщения об ошибках и задержку.
- Проверьте журналы использования Flatkey на предмет строки модели, количества запросов, использования и стоимости.
- Повторите с точными production-настройками: quality, size, background, формат вывода и любые входные изображения.
- Задайте лимиты повторных попыток и условия остановки до того, как откроете функцию для пользователей.
- Сохраните путь отката к предыдущему workflow изображений или прямому маршруту провайдера.
Это та же операционная дисциплина, которая описана в руководстве по миграции на OpenAI-compatible API: меняйте маршрут осознанно, сопоставляйте ID модели, выполняйте небольшой smoke-тест и используйте журналы перед масштабированием.
Когда Flatkey — правильный путь к GPT Image 2 API
Flatkey хорошо подходит, когда ваша функция работы с изображениями является частью более широкой мультимодальной архитектуры. Продукт может использовать текстовые модели для переписывания промптов, модели GPT image для создания ассетов, модели с поддержкой vision для проверки и других провайдеров для резервного сценария или контроля затрат. Один ключ, одна ценовая поверхность и одна панель использования упрощают аудит такого рабочего процесса по сравнению с отдельными аккаунтами провайдеров.
Flatkey не является причиной пропускать проверки на уровне провайдера. Для GPT Image 2 API статус строки, поддержка endpoint и тело запроса должны совпадать перед выводом производственного трафика. Снимок от 17 июня показал наличие в каталоге, а не чистый результат доступности.
Окончательный контрольный список API изображения GPT 2
- Выбрана основная строка модели в ценах Flatkey.
- Подтверждена поддержка endpoint для выбранной строки.
- Проверены единица тарификации и текущая метка в панели управления.
- Выполнен небольшой тест маршрута Flatkey с производственной формой запроса.
- В журналах использования проверены строка, статус, токены или единицы запроса, а также стоимость.
- Настроены лимиты повторных попыток, лимиты квоты и предохранители для поэтапного развёртывания.
- Документирован маршрут отката.
Самый безопасный способ внедрить GPT Image 2 API через Flatkey — рассматривать доступ к модели, поддержку endpoint и тарификацию как единый цикл проверки. Просмотреть цены, чтобы проверить текущие строки Flatkey GPT image перед переносом реального трафика изображений.
