> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API 設定と技術的な接続

## 1. API ベース URL には何を入力すればよいですか？

プロトコルによって、主に以下の種類があります：

* OpenAI 互換形式：[https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai) または [https://api.highwayapi.ai/openai/v1/chat/completions](https://api.highwayapi.ai/openai/v1/chat/completions)
* Anthropic ネイティブプロトコル：[https://api.highwayapi.ai/anthropic](https://api.highwayapi.ai/anthropic) （Claude Code などのツール用）
* 画像生成/動画生成専用：[https://api.highwayapi.ai/v3/](https://api.highwayapi.ai/v3/) （Gemini、Nano Banana など）

注意：404 エラーが発生した場合は、URL の末尾に余分な /v1 が付いていないか確認してください。ツールによってパスの連結ロジックが異なります。

## 2. 呼び出し時に 401「無効なトークン」が返る場合は？

1. API Key が正しく作成されていることを確認してください：[https://jiekou.ai/settings/key-management](https://jiekou.ai/settings/key-management)
2. リクエストヘッダー内の Authorization 形式が次のようになっていることを確認してください：Bearer sk\_xxxxxx
3. Claude Code を使用している場合、環境変数は ANTHROPIC\_AUTH\_TOKEN=sk\_xxxxx に設定してください（Bearer プレフィックスは不要です。ツールが自動的に追加します）

## 3. 呼び出しで 404 "page not found" が返る場合の確認方法は？

よくある原因：

* URL の誤り：例として /v3/glm-asr を使用しているがスペルミスしている
* モデルルーティングの誤り：例として Codex モデルは /v1/chat/completions ではなく /v1/responses を使用する必要がある
* ツールによる自動連結の問題：一部のツール（cc-switch など）は /chat/completions を自動的に追加するため、この場合 Base URL にそのパスを含めないでください

## 4. Claude Code で Jiekou.AI を設定するには？

環境変数の設定は以下の通りです：

Windows cmd：

```
set ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
set ANTHROPIC_MODEL=claude-opus-4-1-20250805
set ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
```

Mac/Linux bash：

```
export ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
export ANTHROPIC_MODEL=claude-opus-4-1-20250805
export ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
```

参考ドキュメント：[https://docs.jiekou.ai/docs/integration/claudecode](https://docs.jiekou.ai/docs/integration/claudecode)

## 5. Claude Code で強制ログイン/認証が必要と表示される場合の解決方法は？

最新版の Claude Code では、ログインが強制的に要求される場合があります。解決方法：

* 代わりに Cline プラグインを使用する（VSCode プラグインマーケットプレイスで検索）
* または cc-switch などの転送ツールと併用する

## 6. GPT-5.1 / Codex モデルはどのように呼び出しますか？なぜ 400 エラーが返りますか？

GPT-5.1 シリーズ（Codex を含む）は、Chat Completions ではなく OpenAI の Responses API を使用する必要があります：

```
curl "https://api.highwayapi.ai/openai/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API Key>" \
-d '{
    "model": "gpt-5.1-codex",
    "input": [...],
    "max_output_tokens": 64000
  }'
```

## 7. Claude 4.5 で "thinking block" に関するエラーが返る場合は？

通常、エラーには次のように表示されます：Expected 'thinking' or 'redacted\_thinking', but found 'text'。これは Claude 4.5 で Thinking 機能を有効にした後、コンテキストに特定の思考ブロック形式が含まれている必要があるためです。推奨対応：

* 会話履歴をクリアして最初からやり直す
* または Thinking 機能を無効にする（不要な場合）
* OpenAI 互換プロトコルではなく、Anthropic ネイティブプロトコルを使用する（前者は Thinking のサポートが不完全な場合があります）

## 8. Claude API の呼び出しで「入力が長すぎます」エラーが返る場合は？

Claude モデルには入力長の制限があります（通常 max\_tokens は最大 64000 まで対応）。以下を確認してください：

* 入力テキストの長さ
* Base64 画像のサイズ（画像が大きすぎる場合は、先に圧縮することを推奨します）
* 履歴会話コンテキストの累積長

***

**サポートへのお問い合わせ**

上記の FAQ で問題を解決できない場合は、以下の方法でテクニカルサポートにお問い合わせください：

* 企業 WeChat/WeChat テクニカルサポートグループ（推奨、応答が最も速い）
* 提供情報の形式：
  * 問題の説明 + スクリーンショット
  * アカウント ID (UUID)
  * Trace ID（ある場合、通常はエラーメッセージ内にあります）
  * リクエストパラメータ（機密情報をマスクしたもの）