チャット補完の作成(Chat Completions)
/v1/chat/completionsNex N2.6 で対話メッセージから応答を生成します。Authorization: Bearer <API Key> で認証し、リクエストボディには application/json を使用します。
本番環境のHTTPリクエストはhttps://api.mosi.cnを使用します。以下の例を実行する前に、MOSS_API_ORIGINをhttps://api.mosi.cnに、MOSS_API_KEYをお使いのMOSS APIキーに設定してください。OpenAI SDKのbase_urlにはhttps://api.mosi.cn/v1を指定します。
リクエストパラメータ
nex-n2.6を使用します。バージョンを固定する必要がある場合はnex-n2.6-2026-11-05を使用します。
対話メッセージです。テキストのみの場合は、role が user のメッセージを 1 件送信できます。対話を続ける場合は、必要な履歴も含めます。
テキストには文字列を使用します。テキストと画像を送信する場合は、text と image_url のコンテンツ項目を含めます。MP4 または WebM の動画は video_url で指定します。
出力トークン数の上限です。本番環境の既定値は 8,192、設定できる上限は 131,072 です。このフィールドと max_completion_tokens はどちらか一方を指定します。
max_tokens の互換フィールドです。このフィールドと max_tokens はどちらか一方を指定します。
true を指定するとストリーミング応答になります。
ストリーミングリクエストで true を指定すると、ストリームの末尾に使用量が返されます。
クライアント側で実行する関数ツールに対応しています。サーバーでホストされるツールは利用できません。
enabled を指定できます。現在、disabled には対応していません。
JSON オブジェクト形式の応答を要求するには json_object を指定します。
auto ではモデルがツールを選択し、none では構造化ツール呼び出しを無効にします。オブジェクトで関数を指定することもできます。
省略できます。明示する場合は 2026-11-05 を指定し、model で選択したスナップショットと一致させてください。
image_url.url に公開 HTTPS URL または完全な Base64 データ URL を指定します。MP4 または WebM の動画は video_url で指定します。公開メディア URL は MOSS からアクセスできる必要があります。エンコード済みメディアを含むリクエストボディ全体は 10 MiB 以下にしてください。現在、ファイル、file_id、アセットライブラリの参照には対応していません。
レスポンスフィールド
応答の生成に使用されたモデルスナップショットです。
最終的なテキストです。推論で出力上限に達した場合は空になることがあります。
クライアントが実行する構造化されたツール呼び出し。
stop は自然終了、length は出力上限への到達、tool_calls はツール呼び出しの生成を示します。
prompt_tokens、completion_tokens、total_tokens を読み取ります。キャッシュされた入力の使用量は prompt_tokens_details.cached_tokens、推論の使用量は completion_tokens_details.reasoning_tokens に含まれます。
推論と最終応答
最終応答は choices[].message.content から読み取ります。ツール呼び出しの assistant メッセージに reasoning_content が含まれる場合、ツールの結果を返す際も保持します。thinking.type には enabled を指定できます。disabled を指定すると、HTTP 400 と invalid_field_value が返されます。
クライアントの接続
OpenAI SDK の base_url には https://api.mosi.cn/v1 を設定します。ストリーミング応答のテキスト、終了理由、使用量は個別に処理します。choices を読み取る前に、配列が空かどうかを確認してください。