コンソール

チャット補完の作成(Chat Completions)

POST/v1/chat/completions

Nex 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を指定します。

リクエストパラメータ

フィールド型指定説明
model: string必須

nex-n2.6を使用します。バージョンを固定する必要がある場合はnex-n2.6-2026-11-05を使用します。

messages: array<object>必須

対話メッセージです。テキストのみの場合は、role が user のメッセージを 1 件送信できます。対話を続ける場合は、必要な履歴も含めます。

messages[].content: string または arrayメッセージの種類による

テキストには文字列を使用します。テキストと画像を送信する場合は、text と image_url のコンテンツ項目を含めます。MP4 または WebM の動画は video_url で指定します。

max_tokens: integer任意

出力トークン数の上限です。本番環境の既定値は 8,192、設定できる上限は 131,072 です。このフィールドと max_completion_tokens はどちらか一方を指定します。

max_completion_tokens: integer任意

max_tokens の互換フィールドです。このフィールドと max_tokens はどちらか一方を指定します。

stream: boolean任意

true を指定するとストリーミング応答になります。

stream_options.include_usage: boolean任意

ストリーミングリクエストで true を指定すると、ストリームの末尾に使用量が返されます。

tools: array<object>任意

クライアント側で実行する関数ツールに対応しています。サーバーでホストされるツールは利用できません。

thinking.type: string任意

enabled を指定できます。現在、disabled には対応していません。

response_format.type: string任意

JSON オブジェクト形式の応答を要求するには json_object を指定します。

tool_choice: string または object任意

auto ではモデルがツールを選択し、none では構造化ツール呼び出しを無効にします。オブジェクトで関数を指定することもできます。

version: string任意

省略できます。明示する場合は 2026-11-05 を指定し、model で選択したスナップショットと一致させてください。

image_url.url に公開 HTTPS URL または完全な Base64 データ URL を指定します。MP4 または WebM の動画は video_url で指定します。公開メディア URL は MOSS からアクセスできる必要があります。エンコード済みメディアを含むリクエストボディ全体は 10 MiB 以下にしてください。現在、ファイル、file_id、アセットライブラリの参照には対応していません。

レスポンスフィールド

フィールド型説明
model: string

応答の生成に使用されたモデルスナップショットです。

choices[].message.content: string

最終的なテキストです。推論で出力上限に達した場合は空になることがあります。

choices[].message.tool_calls: array<object>

クライアントが実行する構造化されたツール呼び出し。

choices[].finish_reason: string

stop は自然終了、length は出力上限への到達、tool_calls はツール呼び出しの生成を示します。

usage: object

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 を読み取る前に、配列が空かどうかを確認してください。

関連ドキュメント