Base URL、インターフェースと認証

ドキュメントは 1ZheAI が管理しています。出典と訂正。

エラーを見つけましたか？ページのアドレスと説明を添えてサポートに連絡してください。API キーやアカウント情報は送信しないでください。

すべてのリクエストは同じドメインに送信され、プロトコルごとに2つのパス体系に分かれます。

text

https://1zheai.com

利用可能なインターフェース

インターフェース	プロトコル	用途
POST /v1/messages	Anthropic ネイティブ	対話。Claude Code、Anthropic SDK、Cline（Anthropic モード）はこちらを使用
POST /v1/chat/completions	OpenAI 互換	対話。OpenAI SDK、Cursor、Cherry Studio（OpenAI モード）はこちらを使用
GET /v1/models	OpenAI 互換	API キーで利用できるモデルの一覧を取得
POST /v1/messages/count_tokens	Anthropic ネイティブ	入力のトークン数を計算。対話は発生せず、課金もされない

count_tokens のリクエストボディは /v1/messages と同じです（model、messages、system と tools を付加可能）。レスポンスには1つのフィールドのみが含まれます：

json

{"input_tokens":19}

count_tokens は送信した内容のみをカウントします。SDK、curl、またはサードパーティツールで実際に呼び出す場合、各リクエストにはシステムプロンプトが付加され、入力トークンとして課金されます（Claude Code は付加されません）。詳細はシステムプロンプトの課金を参照してください。

Prompt Caching、extended thinking、ツール呼び出しなど Claude 固有の機能は、ネイティブの /v1/messages を使うのが最も安定します。OpenAI 互換インターフェースは、既に OpenAI コードがあり、モデルを変えたいだけのケースに適しています。

/v1 を付けるかどうか

ツールごとに Base URL の解釈が異なり、これは接続時の最も一般的な落とし穴です：

ツール / SDK	入力する値	理由
Claude Code（ANTHROPIC_BASE_URL）	https://1zheai.com	ツール自身が /v1/messages を連結する
Anthropic SDK（base_url）	https://1zheai.com	同上
OpenAI SDK（base_url）	https://1zheai.com/v1	SDK は /chat/completions のみを連結する
Cursor（Override OpenAI Base URL）	https://1zheai.com/v1	OpenAI SDK と同じ
Cherry Studio	https://1zheai.com	/v1/... を自動補完する
Cline（OpenAI Compatible）	https://1zheai.com/v1	OpenAI SDK と同じ

ルール：Anthropic 系はルートアドレスを入力し、OpenAI 系は /v1 まで入力します。入力間違えの典型的な症状は 404 です。

認証リクエストヘッダー

API キーはリクエストヘッダーに置きます。次の2つの書き方のどちらでも構いません：

Anthropic 原生

Anthropic 原生

x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json

Bearer（两种协议都支持）

Bearer（两种协议都支持）

Authorization: Bearer sk-你的Key
content-type: application/json

• /v1/messages を呼び出す際は、公式プロトコルに従い anthropic-version を付加してください。現在の値は 2023-06-01 です。実測では付けていなくても呼び出せますが、公式 SDK とツールはすべて付加するため、自前でリクエストを書く場合も同様に付けてください。
• Claude Code の ANTHROPIC_AUTH_TOKEN は Authorization: Bearer を送信し、ANTHROPIC_API_KEY は x-api-key を送信します。どちらも受け付けます。
• beta 機能が必要な場合は、公式ドキュメントに従い anthropic-beta ヘッダーを付加してください。認識されない値を付けてもエラーにはならないため、ある beta 機能が有効かどうかはレスポンスの実際の効果で判断してください。

API キーが利用可能かの確認

bash

curl https://1zheai.com/v1/models \
  -H "Authorization: Bearer sk-你的Key"

モデル一覧が返れば、API キーとアドレスの両方が正しいことを意味します。401 が返った場合は API キーの問題で、レスポンスは次のようになります（2026-10-15 実測）：

json

{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}

x-api-key と anthropic-version ヘッダーを付けて /v1/models をリクエストすると、Anthropic 形式のモデル一覧（data[].id、display_name、has_more）が返ります。Claude Code のモデル自動検出はこの形式を読み取ります。

その他の場合はエラーコードとトラブルシューティングを参照してください。

レート制限

現在、API キーに対してレート制限は設けていません。429 を受け取った場合、通常は上流の負荷が高いため、少し待ってから再試行してください。バッチタスクには指数バックオフを追加してください。詳細はエラーコードとトラブルシューティングを参照してください。

ネットワーク

接続タイムアウトや TLS エラーが発生した場合は、まず端末が利用しているネットワークを確認してください。グローバルプロキシが有効な場合は、プロキシをオフにして直接接続で再試行してください。会社のネットワークに出口ホワイトリストがある場合は、1zheai.com の許可が必要です。