Интеграция Codex для GPT-Image завершается ошибкой из-за неверного API-ключа

Ошибка

Authentication failed
Incorrect API key provided: sk-xxxx****************************A6Af.
You can find your API key at https://platform.openai.com/account/api-keys.
(Request ID: req_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

Одним предложением: эта ошибка возвращается собственными серверами OpenAI, а не APIYI. Ваш код сейчас вызывает api.openai.com, поэтому OpenAI отклоняет ключ APIYI. С ключом всё в порядке. Неверен адрес запроса.

Как определить, что запрос так и не дошёл до APIYI

Любой из этих двух признаков однозначно это подтверждает:

Признак	Значение
Ошибка направляет вас на `platform.openai.com/account/api-keys`	Это стандартный текст ошибки `invalid_api_key` от OpenAI. Ошибки APIYI никогда не направляют вас на сайт OpenAI
ID запроса — это строка из 32 символов, начинающаяся с `req_`	Формат ID запроса OpenAI. Вы не найдёте его в логах APIYI, потому что запрос туда никогда не поступал

Это особенно часто происходит, когда вы просите AI-ассистента для программирования написать интеграцию. Codex, Cursor, Claude Code и другие видят имя модели gpt-image-2.5, по умолчанию используют шаблон официального OpenAI SDK и оставляют base_url со значением SDK по умолчанию https://api.openai.com/v1. Ключ, который вы вставляете, принадлежит APIYI. Они не совпадают.

Три способа решения — выберите по ситуации

① Используете Codex / Agent для программирования: установите Skills
② Не программист: передайте prompt вашему AI
③ Интеграция не нужна: генерируйте в веб-интерфейсе

Самый простой путь — позволить Agent «изучить» APIYI до того, как он начнёт писать код. Доступны два уровня наборов навыков:

Набор навыков для всего сайта (установите сначала его)

Попросите ваш Agent выполнить команду ниже, чтобы установить набор навыков APIYI. Если это не сработает, попросите его прочитать https://docs.apiyi.com/skill.md напрямую:

npx skills add https://docs.apiyi.com

Этот файл написан для AI: базовые URL, аутентификация, правила именования моделей и распространённые ошибки. После установки написанный им код будет автоматически направлять base_url на https://api.apiyi.com/v1.

Специализированный навык GPT-Image

Страница навыка Agent для серии GPT-Image-2.5 / 2 содержит готовый к использованию Skill: два файла и один скрипт для шести моделей, включая gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2, с переключением через --model. Включены преобразование текста в изображение, объединение нескольких изображений и inpainting.Добавьте его в Codex, OpenClaw, Claude Code или любой Agent для программирования, который может выполнять shell-команды, затем просто скажите «сгенерируй изображение …». Вам не потребуется самостоятельно работать с базовым URL.

Для других моделей изображений и видео также есть страницы «Agent Skill», размещённые в папке документации соответствующей модели. Найдите модель в левой навигации и найдите подстраницу с названием «Agent Skill».

Если вы не хотите разбираться, что такое Skill, скопируйте наш готовый prompt для интеграции в Codex, Claude Code, Cursor или любой AI-ассистент:

Откройте обзор GPT-Image-2.5 / 2
Найдите раздел «Поручите интеграцию AI Agent» и нажмите кнопку копирования prompt
Вставьте его в ваш AI-ассистент для программирования без изменений

В prompt уже жёстко задано base_url как https://api.apiyi.com/v1, ключ считывается из переменной окружения APIYI_API_KEY, а также предусмотрены типичные проблемы с тайм-аутами, отображением base64, сжатием при загрузке и параметрами качества. AI сначала получает текстовую версию страницы документации (добавьте .md к любому URL документации), а затем пишет код для стека вашего проекта.

Такой prompt есть на странице обзора каждой модели изображений и видео, не только GPT-Image. Для трёх более универсальных путей (чат Agent, CLI, Agent для программирования) см. набор разработчика AI.

Если вам пока нужны только изображения и не требуется использовать их в собственной программе, полностью пропустите работу с кодом:

Скопируйте ключ со страницы «Tokens» в консоли APIYI
Откройте imagen.apiyi.com и вставьте ключ
Выберите gpt-image-2.5-flare (текст в изображение) или gpt-image-2.5-sunburst (редактирование) и сгенерируйте

Веб-инструмент использует тот же ключ и тот же API, а тарификация списывается с баланса того же аккаунта. Когда позднее вам понадобится использовать его в приложении, вернитесь к первым двум способам.

Исправьте сами: одна строка

Если у вас уже есть код, сгенерированный Codex, минимальное изменение — добавить base_url в клиент. Всё остальное оставьте без изменений:

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-apiyi-key",
    base_url="https://api.apiyi.com/v1",  # ← add this line
)

result = client.images.generate(
    model="gpt-image-2.5-flare",
    prompt="A shiba inu wearing an astronaut helmet, cyberpunk style",
    size="1024x1024",
    quality="medium",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-apiyi-key",
  baseURL: "https://api.apiyi.com/v1", // ← add this line
});

const result = await client.images.generate({
  model: "gpt-image-2.5-flare",
  prompt: "A shiba inu wearing an astronaut helmet, cyberpunk style",
  size: "1024x1024",
  quality: "medium",
});

# Override the SDK default without touching code
export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

Затем убедитесь, что запрос действительно достигает APIYI. Список моделей в ответе означает, что всё готово:

curl https://api.apiyi.com/v1/models \
  -H "Authorization: Bearer sk-your-apiyi-key"

Дополнительные вопросы

Я изменил base_url, но всё равно получаю ту же ошибку. Почему?

Проверьте по порядку:

Несколько расположений конфигурации: проекты, сгенерированные Codex, часто задают URL в .env, файле конфигурации и конструкторе клиента. Изменение одного из них оставляет остальные со значением по умолчанию
Приоритет переменных окружения: если OPENAI_BASE_URL уже задана в вашей системе иначе, она переопределяет всё, что не указано в коде. Выполните echo $OPENAI_BASE_URL для проверки
Нет перезапуска: запущенный процесс по-прежнему использует старую конфигурацию
Правописание: apiyi, а не apiyii или apiyl

Самое простое подтверждение — сам текст ошибки. Пока в нём по-прежнему отображается platform.openai.com, запрос всё ещё отправляется в OpenAI.

Codex сообщает, что уже переключился на APIYI, но ошибка не изменилась.

Отправьте ему точный текст ошибки вместе с этой страницей. На каждой странице документации в правом верхнем углу есть кнопка «Копировать страницу». Вставьте содержимое страницы и ошибку в AI, и он сможет определить, какая конфигурация не вступила в силу. Это самый быстрый способ устранения неполадок.

Что делать, если ключ всё ещё отклоняется после того, как запрос достигает APIYI?

Только тогда следует проверить сам ключ: откройте страницу «Tokens» в консоли и убедитесь, что ключ включён, баланс достаточен и его не блокирует белый список моделей. Полный контрольный список приведён в разделе Почему мой API Key недействителен?.

Какое имя модели следует использовать для gpt-image-2.5?

По умолчанию используйте gpt-image-2.5-flare для преобразования текста в изображение и gpt-image-2.5-sunburst для редактирования и дорисовки. Обе модели имеют одинаковую цену и параметры. Для высокообъёмных задач с низкой стоимостью используйте обратный канал gpt-image-2.5-all. Сравнительная таблица на странице Навык агента серии GPT-Image охватывает все шесть вариантов.

Связанные материалы

Почему мой API Key недействителен?

Почему базовый URL и ключ должны соответствовать друг другу: примеры для всех языков.

Как настроить базовый URL?

/v1 для OpenAI, корневой домен для Claude, /v1beta для Gemini.

Доступна ли интеграция в один клик?

Передайте документацию своему AI-помощнику для написания кода и позвольте ему выполнить интеграцию.

Обзор GPT-Image-2.5 / 2

Параметры, тарификация, промпт для интеграции и распространённые ошибки.

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

Интеграция Codex для GPT-Image завершается ошибкой из-за неверного API-ключа

Ошибка

Как определить, что запрос так и не дошёл до APIYI

Три способа решения — выберите по ситуации

Исправьте сами: одна строка

Дополнительные вопросы

Связанные материалы

Почему мой API Key недействителен?

Как настроить базовый URL?

Доступна ли интеграция в один клик?

Обзор GPT-Image-2.5 / 2

​Ошибка

​Как определить, что запрос так и не дошёл до APIYI

​Три способа решения — выберите по ситуации

​Исправьте сами: одна строка

​Дополнительные вопросы

​Связанные материалы

Почему мой API Key недействителен?

Как настроить базовый URL?

Доступна ли интеграция в один клик?

Обзор GPT-Image-2.5 / 2

Ошибка

Как определить, что запрос так и не дошёл до APIYI

Три способа решения — выберите по ситуации

Исправьте сами: одна строка

Дополнительные вопросы

Связанные материалы