GPT-Image の Codex 統合が誤った 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)

一言で言うと：このエラーはAPIYIではなく、OpenAI独自のサーバーによって返されています。現在、コードはapi.openai.comを呼び出しているため、OpenAIがAPIYIキーを拒否しています。キーは問題ありません。リクエストアドレスが間違っています。

リクエストがAPIYIに到達していないことを見分ける方法

次の2つの兆候のいずれかがあれば、結論は明確です。

兆候	意味
エラーで `platform.openai.com/account/api-keys` に誘導される	これはOpenAIの標準的な`invalid_api_key`テキストです。APIYIのエラーでOpenAIのウェブサイトに誘導されることはありません
リクエストIDが `req_` で始まる32文字の文字列である	OpenAIのリクエストID形式です。リクエストはAPIYIに到達していないため、APIYIのログには表示されません

これは、AIコーディングアシスタントに統合コードの作成を依頼した場合に特によく起こります。Codex、Cursor、Claude Codeなどはモデル名 gpt-image-2.5 を確認すると、デフォルトで公式のOpenAI SDKパターンを使用し、base_url をSDKのデフォルト値 https://api.openai.com/v1 のままにします。貼り付けたキーはAPIYIのものです。この2つは一致しません。

状況に応じて選べる3つの解決策

① Codex / コーディングエージェントを使用する場合：スキルをインストールする
② コーダーではない場合：プロンプトをAIに渡す
③ 統合が不要な場合：ウェブ上で生成する

最も手間がかからない方法は、コードを書く前にエージェントにAPIYIを「学習」させることです。スキルパックは2段階で利用できます。

サイト全体用スキルパック（最初にインストール）

エージェントに以下のコマンドを実行させて、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専用スキル

GPT-Image-2.5 / 2 シリーズ・エージェントスキルのページには、すぐに使えるスキルが用意されています。2つのファイルと1つのスクリプトで、gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2を含む6つのモデルに対応し、--modelで切り替えられます。テキストから画像への変換、複数画像の融合、インペインティングがすべて含まれています。これをCodex、OpenClaw、Claude Code、またはシェルコマンドを実行できる任意のコーディングエージェントに配置し、「…の画像を生成して」と言うだけです。ベースURLを自分で変更する必要はありません。

その他の画像モデルや動画モデルにも、それぞれの「エージェントスキル」ページがあります。各モデルのドキュメントフォルダーに掲載されています。左側のナビゲーションでモデルを見つけ、「エージェントスキル」という名前のサブページを探してください。

スキルとは何かを学びたくない場合は、すぐに使える統合プロンプトをCodex、Claude Code、Cursor、または任意のAIアシスタントにコピーしてください。

GPT-Image-2.5 / 2 概要を開きます
「AIエージェントに統合を任せる」セクションを見つけ、プロンプトのコピーボタンをクリックします
そのままAIコーディングアシスタントに貼り付けます

このプロンプトにはbase_urlがhttps://api.apiyi.com/v1としてあらかじめ設定されており、APIYI_API_KEY環境変数からキーを読み込みます。また、タイムアウト、base64の表示、アップロード時の圧縮、品質パラメーターに関する一般的な落とし穴にもあらかじめ対処しています。AIはまずドキュメントページのプレーンテキスト版を取得し（任意のドキュメントURLに.mdを追加します）、その後、プロジェクトの技術スタック向けにコードを作成します。

GPT-Imageだけでなく、すべての画像モデルおよび動画モデルの概要ページに、このようなプロンプトが用意されています。より一般的な3つの方法（チャットエージェント、CLI、コーディングエージェント）については、AI開発キットを参照してください。

画像だけが必要で、まだ自分のプログラム内で使用する必要がない場合は、コードを完全に省略できます。

APIYIコンソールの「Tokens」ページからキーをコピーします
imagen.apiyi.comを開き、キーを貼り付けます
gpt-image-2.5-flare（テキストから画像への変換）またはgpt-image-2.5-sunburst（編集）を選択して生成します

ウェブツールでは同じキーと同じAPIが使用され、同じアカウントの残高に対して課金されます。後でアプリ内で使用する必要が生じたら、最初の2つの方法に戻ってください。

自分で修正する：1行

すでに 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、設定ファイル、クライアントコンストラクターに設定されていることがよくあります。1か所を変更しても、他の場所はデフォルトのままです
環境変数の優先順位: システム上ですでに 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 シリーズ Agent Skill ページの比較表に、6つすべてがまとめられています。

API Keyが無効なのはなぜですか？

ベースURLとキーを一致させる必要がある理由を、各言語の例とともに説明します。

ベースURLの設定方法

OpenAIの場合は/v1、Claudeの場合はルートドメイン、Geminiの場合は/v1betaです。

ワンクリック統合に対応していますか？

ドキュメントをAIコーディングアシスタントに渡すだけで、統合を任せられます。

GPT-Image-2.5 / 2の概要

パラメータ、料金、統合用プロンプト、よくあるエラーについて説明します。

概要

サイト機能

モデルとAPI

tokensとログ

法人向けサービス

課金とセキュリティ

ネットワークと接続

アカウントとログイン

GPT-Image の Codex 統合が誤った API キーで失敗する

エラー

リクエストがAPIYIに到達していないことを見分ける方法

状況に応じて選べる3つの解決策

自分で修正する：1行

フォローアップの質問

関連

API Keyが無効なのはなぜですか？

ベースURLの設定方法

ワンクリック統合に対応していますか？

GPT-Image-2.5 / 2の概要

​エラー

​リクエストがAPIYIに到達していないことを見分ける方法

​状況に応じて選べる3つの解決策

​自分で修正する：1行

​フォローアップの質問

​関連

API Keyが無効なのはなぜですか？

ベースURLの設定方法

ワンクリック統合に対応していますか？

GPT-Image-2.5 / 2の概要

エラー

リクエストがAPIYIに到達していないことを見分ける方法

状況に応じて選べる3つの解決策

自分で修正する：1行

フォローアップの質問

関連