/v1/chat/completions
OpenAI SDK、Cherry Studio、Cline、Open WebUI など、ほとんどのツールクライアントで利用できます。
リクエスト形式
/
該当するものがありません。プロトコル名、機能名、エンドポイントのパスで試してください。
3 つのリクエスト形式でカタログ全体をカバーします。1 つの ChinaAPI キーと 1 つの Base URL がそのすべてで使えるので、クライアントがすでに話せる形式で送ってください。
/v1/messages
同じゲートウェイキーとクォータ制御を維持したまま、Claude 形式のメッセージペイロードをルーティングします。
/v1/responses
Codex をはじめ Responses API 上に構築されたクライアントで使用します。対応するモデルはコンソールに表示されます。
Gemini モデル専用
ネイティブの Gemini リクエストは
POST /v1beta/models/{model}:generateContent に送ります。提供しているのは gemini-* のモデルだけで、しかもそのすべてではありません——各モデルが受け付ける形式は Models のモデル項目に記載しています。それ以外はすべて上の 3 つの形式のいずれかを使います。
タイムアウトと課金
課金されるのは、クライアントに届いた出力だけです。非ストリーミングのレスポンスが返る前にクライアントが切断またはタイムアウトした場合、そのリクエストは課金されません。ストリーミングのリクエストは、入力と、ストリーム終了までに届いた出力に対して課金され、出力が 1 つも届かなかった場合は課金されません。何も届かないうちに時間予算を使い切ったリクエストは
504 エラーで終了し、課金されません。クライアントが待つ時間は X-Request-Timeout ヘッダーに秒数で指定してください。OpenAI と Anthropic の公式 SDK は、自身のタイムアウトをすでに送信しています。
複数ターンの Responses 会話は previous_response_id で前の応答を参照します。続きのリクエストが previous_response_not_found を返しても、前の応答が失われたわけではありません。会話を作り直さず、10〜20 秒待ってから同じリクエストを送り直してください。