第 21 章 / 全 21 章約 2 分

21. よくある質問(FAQ)#

Q:既存の OpenAI コードはどのくらい変更が必要ですか? A:通常は baseURL と apiKey の 2 か所だけです。その他のリクエストパラメータはそのままで構いません。

Q:OpenAI 公式 SDK をそのまま使えますか? A:使えます。主要言語の OpenAI SDK はすべてカスタム baseURL をサポートしており、http://183.240.79.21:52099/v1 を指すだけで利用できます。

Q:Claude / Gemini などの非 OpenAI モデルはどう呼び出せばよいですか? A:/v1/chat/completions で統一的に呼び出し、model を対応するモデル名に変更するだけで、プロトコルの切り替えは不要です。Anthropic ネイティブプロトコルを使う必要がある場合は、/v1/messages を利用できます(関数呼び出し / マルチモーダルには非対応)。

Q:現在のキーでどのモデルが使えるかを知るには? A:GET /v1/models を呼び出してください。返却されるのが、現在アクセス権のあるモデルの一覧です。

Q:呼び出しが 404 になる場合はどうすればよいですか? A:まずパスの /v1 が 1 つだけであることを確認してください(/v1/chat/completions であり、/v1/v1/... ではありません)。次に、モデル名のスペルが正しく、GET /v1/models の返却一覧に含まれていることを確認してください。

Q:ストリーミングレスポンスの終了はどう判断しますか? A:OpenAI 系エンドポイントの SSE ストリームは、data: [DONE] が終了マーカーです。/v1/messages エンドポイントは Anthropic 形式の SSE イベント列を返します。

Q:動画 / 画像生成タスクにはどのくらい時間がかかりますか? A:非同期タスクです。送信後に返された id で /v1/tasks/{id} をポーリングし、ステータスが完了になるまでお待ちください。

Q:API キーの平文を保存し忘れました。どうすればよいですか? A:セキュリティのため、平文は作成時に 1 回だけ表示され、再取得はできません。コンソールで古いキーを失効させ、新しいキーを作成してください。


本文書内のドメイン http://183.240.79.21:52099 はプレースホルダーです。正式リリース後は、実際のサービスドメインに置き換えてください。 ローカル開発環境のベース URL は http://183.240.79.21:52099/v1 です。