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

よくあるエラー症状

このようなエラーメッセージが表示されたら:

{
  "error": {
    "message": "Incorrect API key provided: sk-QqHvK***...",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

これは通常、API Key が間違っているのではなく、Base URL が誤って設定されていることを意味します。

最もよくあるミス: APIYI の Key を使っているのに、OpenAI の公式エンドポイントへリクエストを送っている https://api.openai.com

Base URLとは？

Base URL（Base URL / リクエスト先アドレス）は、APIリクエストの送信先サーバーアドレスです。APIサービスプロバイダーによって、Base URL は異なります。

Base URLとAPI Keyは一致する必要があります

Service Provider	Base URL	API Key Format	Match?
APIYI	`https://api.apiyi.com`	`sk-xxxx......`	✅ 正しい
OpenAI 公式	`https://api.openai.com`	`sk-xxxx......`	✅ 正しい
❌ APIYI キー	`https://api.openai.com`	`sk-xxxx......`	❌ 誤り
❌ OpenAI キー	`https://api.apiyi.com`	`sk-xxxx......`	❌ 誤り

重要な原則: API Key のプロバイダーに一致する Base URL を使用してください。

正しい設定

方法1: Base URL を変更する（推奨）

OpenAI のエンドポイントを APIYI のものに置き換えるだけで、他はそのままです:

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-apiyi-key",  # Get Key from APIYI dashboard
    base_url="https://api.apiyi.com/v1"  # Change to APIYI address
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}]
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-apiyi-key',  // Get Key from APIYI dashboard
  baseURL: 'https://api.apiyi.com/v1'  // Change to APIYI address
});

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello' }]
});

curl https://api.apiyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-apiyi-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

方法2: 環境変数を使う

コード内で Base URL を指定しなくて済むように、環境変数を設定します:

export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

$env:OPENAI_API_KEY="sk-your-apiyi-key"
$env:OPENAI_BASE_URL="https://api.apiyi.com/v1"

set OPENAI_API_KEY=sk-your-apiyi-key
set OPENAI_BASE_URL=https://api.apiyi.com/v1

サポートされる Base URL 形式

APIYI は、コードに応じて 3 種類の Base URL 形式をサポートしています。

形式 1: /v1 付き（推奨）
形式 2: /v1/ 付き（末尾スラッシュ）
形式 3: 完全パス

https://api.apiyi.com/v1

ユースケース: ほとんどのライブラリは、Base URL に特定のパスを自動で追加します完全なリクエスト例:

https://api.apiyi.com/v1/chat/completions
https://api.apiyi.com/v1/models

https://api.apiyi.com/v1/

ユースケース: 一部のフレームワークでは、Base URL の末尾にスラッシュが必要です完全なリクエスト例:

https://api.apiyi.com/v1/chat/completions
https://api.apiyi.com/v1/models

https://api.apiyi.com/v1/chat/completions

ユースケース: 完全な API エンドポイントを直接使用します（例: cURL リクエスト）

この方法は通常、cURL または生の HTTP ライブラリのリクエストで使用され、Base URL を設定する必要はありません

トラブルシューティング

Base URL が正しいことは確認しましたが、まだエラーが出ます

考えられる原因:

複数の設定箇所: 設定ファイル、環境変数、コードの初期化などで Base URL が設定されていないか確認してください。
プロキシまたはミドルウェア: 一部のプロキシツールはリクエストをリダイレクトする場合があります
キャッシュの問題: プログラムを再起動するか、キャッシュをクリアして再試行してください
タイプミス: apiyi が正しく綴られているか確認してください（apiyii や apiyl ではありません）

Key が有効かどうかを確認するには？

APIYI ダッシュボードで確認します:

APIYI ダッシュボード console.apiyi.com にログインする
「Tokens」ページへ移動する
Key のステータスが「Enabled」か確認する
アカウントに十分な残高があることを確認する

サードパーティ製ツール（ChatBox、OpenCat など）を設定するには？

多くのサードパーティ製ツールには「Custom API」または「Self-hosted Server」オプションがあります:

API Address / Base URL: https://api.apiyi.com/v1
API Key: APIYI ダッシュボードから Key をコピーします
Model Name: APIYI ドキュメントのモデル一覧を参照してください

設定オプションは通常、「Settings」→「API」または「Server」セクションにあります

コード例はどこで見つけられますか？

APIYI は複数の言語で完全なコード例を提供しています:

Quick Start Documentation: ホームページ → Code Examples
Online Testing Tool: ダッシュボード → ApiFox Online Testing
GitHub Repository: github.com/apiyi/docs → knowledge-base ディレクトリ

誤りと正解の例

❌ 誤った設定

client = OpenAI(
    api_key="sk-apiyi-key",
    base_url="https://api.openai.com/v1"
    # ❌ Using OpenAI official endpoint
)

結果: OpenAI サーバーは APIYI のキーを拒否します

✅ 正しい設定

client = OpenAI(
    api_key="sk-apiyi-key",
    base_url="https://api.apiyi.com/v1"
    # ✅ Using APIYI endpoint
)

結果: リクエストは APIYI サーバーに正常に送信されました

簡易テスト方法

cURL コマンドを使って、設定をすばやく確認します:

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

期待される結果: 利用可能なモデルの一覧を返します

{
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      ...
    }
  ]
}

エラーが出る場合は、次を確認してください:

API Key が正しくコピーされているか（先頭または末尾の空白に注意してください）
ネットワーク接続が正常に動作しているか
アカウントに十分な残高があるか

サイト機能

モデルとAPI

tokensとログ

法人向けサービス

課金とセキュリティ

ネットワークと接続

アカウントとログイン

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

よくあるエラー症状

Base URLとは？

Base URLとAPI Keyは一致する必要があります

正しい設定

方法1: Base URL を変更する（推奨）

方法2: 環境変数を使う

サポートされる Base URL 形式

トラブルシューティング

誤りと正解の例

❌ 誤った設定

✅ 正しい設定

簡易テスト方法

関連ドキュメント

​よくあるエラー症状

​Base URLとは？

​Base URLとAPI Keyは一致する必要があります

​正しい設定

​方法1: Base URL を変更する（推奨）

​方法2: 環境変数を使う

​サポートされる Base URL 形式

​トラブルシューティング

​誤りと正解の例

❌ 誤った設定

✅ 正しい設定

​簡易テスト方法

​関連ドキュメント

よくあるエラー症状

Base URLとは？

Base URLとAPI Keyは一致する必要があります

正しい設定

方法1: Base URL を変更する（推奨）

方法2: 環境変数を使う

サポートされる Base URL 形式

トラブルシューティング

誤りと正解の例

簡易テスト方法

関連ドキュメント