---
title: "Base URL、インターフェースと認証"
description: "1折AI の Base URL、利用可能なインターフェース、リクエストヘッダーの書き方、および各ツールで /v1 を付けるかどうか。"
headingIds: {"利用可能なインターフェース":"section-1","/v1 を付けるかどうか":"section-2","認証リクエストヘッダー":"section-3","API キーが利用可能かの確認":"section-4","レート制限":"section-5","ネットワーク":"section-6"}
---
すべてのリクエストは同じドメインに送信され、プロトコルごとに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 は付加されません）。詳細は[システムプロンプトの課金](/ja/docs/pricing-explained/#section-3)を参照してください。
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つの書き方のどちらでも構いません：
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="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 のモデル自動検出はこの形式を読み取ります。
その他の場合は[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/)を参照してください。
## レート制限
現在、API キーに対してレート制限は設けていません。429 を受け取った場合、通常は上流の負荷が高いため、少し待ってから再試行してください。バッチタスクには指数バックオフを追加してください。詳細は[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/)を参照してください。
## ネットワーク
接続タイムアウトや TLS エラーが発生した場合は、まず端末が利用しているネットワークを確認してください。グローバルプロキシが有効な場合は、プロキシをオフにして直接接続で再試行してください。会社のネットワークに出口ホワイトリストがある場合は、`1zheai.com` の許可が必要です。