控制台

创建对话补全(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 Key。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 的消息,继续对话时带上所需历史。

messages[].content: string 或 array按消息类型

文本使用字符串。图文消息使用包含 text 和 image_url 的内容项。视频通过 video_url 传入,支持 MP4、WebM。

max_tokens: integer可选

输出 Token 预算,生产默认 8192,参数上限 131072。与 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_object 时,请求 JSON 对象形式的回复。

tool_choice: string 或 object可选

auto 由模型选择工具;none 禁用结构化工具调用;也可以传入对象指定函数。

version: string可选

可省略。显式传入时使用 2026-11-05,须与 model 指定的快照一致。

图片地址填入 image_url.url,可使用公网 HTTPS URL 或完整的 Base64 data URL。视频通过 video_url 传入,支持 MP4、WebM。公网媒体地址须能被 MOSS API 访问。媒体编码后的完整请求体不得超过 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 前先检查数组是否为空。