---
title: "API 接続のよくある質問"
description: "Base URL、モデル、ストリーミング、クライアント、タイムアウト、稼働監視のよくある質問を確認できます。"
headingIds: {"接続先、API キーとモデル":"section-1","リクエストとクライアント":"section-2","サービス状態とヘルプ":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

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

</aside>
## 接続先、API キーとモデル

<AccordionGroup>
<Accordion title="Base URL に /v1 を付けるべきですか？">

OpenAI SDK には `https://1zheai.com/v1`、Anthropic SDK と Claude Code には `https://1zheai.com` を入力します。curl を直接使う場合は完全なリクエストパスを入力します。デスクトップツールによってはパスを自動補完するものがあります。[アドレス対応表](/ja/docs/base-url/)を参照してください。

</Accordion>
<Accordion title="ChatGPT や Claude のサブスクリプションがあっても、このサイトのキーは必要ですか？">

必要です。本サイトへの接続には、本サイトのコンソールで作成した API キーを使用します。コンシューマー向けクライアントのサブスクリプションと本サイトの API 認証情報は、異なる接続方法です。ツールはカスタムプロバイダーまたは API アドレスに対応している必要があります。

</Accordion>
<Accordion title="モデルリストにはあるのに、なぜ呼び出しは失敗するのですか？">

一覧に表示されるのは、現在のキーから見えるモデルであり、リアルタイムの推論成功率ではありません。インターフェースプロトコル、オプションパラメーター、上流の状態も確認してください。[モデルクエリインターフェース](/ja/docs/api-models/)を参照してください。

</Accordion>
<Accordion title="他のプラットフォームのモデル名はそのまま使えますか？">

本サイトのモデル一覧から完全な ID をコピーしてください。プロバイダーによっては異なるプレフィックス、エイリアス、日付バージョンが使われるため、推測で名前を変更しないでください。移行手順は[移行ガイド](/ja/docs/migration/)を参照してください。

</Accordion>
</AccordionGroup>

## リクエストとクライアント

<AccordionGroup>
<Accordion title="呼び出しは成功したのに、テキストが取得できない？">

まずレスポンスプロトコルを確認してください。Chat Completions は `choices[].message.content` を読み、Messages は `content` のテキストブロックを走査し、Responses は `output` を走査するか、SDK の `output_text` を使用します。ツール呼び出しのレスポンスには通常のテキストが含まれない場合もあります。

</Accordion>
<Accordion title="前回の内容がなぜ記憶されていないのですか？">

マルチターン会話にはクライアント側で履歴を渡す必要があります。同じキーを繰り返し使用しても、サーバー側のセッションが自動的に作成されることはありません。Responses のセッション関連拡張は個別にサポートを確認し、デフォルトで依存しないでください。

</Accordion>
<Accordion title="ストリーミングでテキストを受信しましたが、成功とみなせますか？">

終了イベントまたは最終状態の確認も必要です。途中のエラー、ストリームの切断、出力の切り捨ては、すでに一部のテキストを受信した後に発生する可能性があります。詳細は[ストリーム出力](/ja/docs/streaming/)を参照してください。

</Accordion>
<Accordion title="タイムアウト後は無限に再試行できますか？">

推奨しません。タイムアウトはリクエストが処理された後に発生する可能性があります。まず呼び出しログを確認し、回数制限、バックオフ、総待機時間に従ってリトライを実行してください。SDK とアプリケーションがそれぞれリトライするのを防ぎます。[タイムアウトとリトライ](/ja/docs/retries/)を参照してください。

</Accordion>
<Accordion title="API キーをウェブフロントエンドに直接置いてもよいですか？">

ブラウザスクリプトや公開リポジトリにキーをコンパイルしないでください。サーバー側で認証情報を保持してインターフェースを呼び出し、ブラウザは自分のバックエンドにのみ接続してください。サンプルコードの環境変数はサーバーまたはローカルターミナル用です。

</Accordion>
</AccordionGroup>

## サービス状態とヘルプ

<AccordionGroup>
<Accordion title="実行時間監視は正常なのに、なぜモデルはエラーを出すのですか？">

監視は公式サイト、コンソール、API エントリポイントの HTTP アクセシビリティをチェックするもので、各モデルの推論成功率を示すものではありません。監視とアプリケーションは同じサーバーにデプロイされており、サーバー全体の障害時には監視も停止します。履歴データは有効化後から蓄積されます。

</Accordion>
<Accordion title="サポートに連絡する際に何を準備すべきですか？">

発生時刻とタイムゾーン、クライアントバージョン、モデル ID、完全なリクエストパス、HTTP ステータスコード、リクエスト ID、マスキング済みのエラー情報を提供してください。キー、認証リクエストヘッダー、プライベートな会話内容は削除してください。[デバッグテンプレート](/ja/docs/troubleshooting/)に従って整理できます。

</Accordion>
</AccordionGroup>