创建对话补全(Chat Completions)
/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。
请求参数
使用 nex-n2.6。需要固定版本时使用 nex-n2.6-2026-11-05。
对话消息。纯文本请求可传入一条 role 为 user 的消息,继续对话时带上所需历史。
文本使用字符串。图文消息使用包含 text 和 image_url 的内容项。视频通过 video_url 传入,支持 MP4、WebM。
输出 Token 预算,生产默认 8192,参数上限 131072。与 max_completion_tokens 二选一。
max_tokens 的兼容字段。与 max_tokens 二选一。
传 true 开启流式响应。
流式请求传 true 时读取流末用量。
仅支持由客户端执行的函数工具。服务端托管工具不适用。
可传 enabled。当前不支持 disabled。
设为 json_object 时,请求 JSON 对象形式的回复。
auto 由模型选择工具;none 禁用结构化工具调用;也可以传入对象指定函数。
可省略。显式传入时使用 2026-11-05,须与 model 指定的快照一致。
图片地址填入 image_url.url,可使用公网 HTTPS URL 或完整的 Base64 data URL。视频通过 video_url 传入,支持 MP4、WebM。公网媒体地址须能被 MOSS API 访问。媒体编码后的完整请求体不得超过 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 前先检查数组是否为空。