返回模型调用 API 参考POST/v1/chat/completions
Qwen 翻译:专用参数与兼容边界
说明 Qwen-MT 翻译参数与普通 Chat 翻译的区别。
支持范围
Qwen-MT 是专用翻译模型,官方使用 translation_options 指定源语言、目标语言及术语。本目录的通用 Chat 参数不保证透传该对象,因此这里不提供可能丢失目标语言的本站 Qwen-MT 示例。
可用方案
一般文字翻译可用 Chat 文本调用,在 user 内容中明确源语言、目标语言、术语和格式。它属于提示词驱动翻译,不等同于 Qwen-MT 专用参数。
必须使用 Qwen-MT 时,先向本站支持确认该模型对应的公开入口和 translation_options 支持情况;提供模型名和脱敏请求即可,不需提供 API Key。不要仅因请求返回200便认定翻译参数生效。
官方参数区别
官方 translation_options.source_lang / target_lang 放在对象内,不是 OpenAI 通用字段;qwen-mt-turbo 与 qwen-mt-plus 等具体型号有各自可用性。不要用 enable_thinking 替代翻译设置。
参考:阿里云 Qwen-MT API。
Chat Completions 兼容协议
调用与返回说明
适合已经依赖 Chat Completions 的客户端和模型。新建 OpenAI 集成时优先确认模型支持 Responses API,再决定是否使用此兼容协议。
请求时注意
- model 和 messages 是基本必填项;tools、tool_choice、response_format 等能力参数按场景发送,不是所有模型都支持。
- 模型 ID 以 GET /v1/models 的返回为准。示例中的固定模型名只是格式示例,不代表当前账号一定可用。
- 对于新推理模型,优先使用 max_completion_tokens;max_tokens 是旧字段,且可能与推理模型不兼容。
返回时注意
- 非流式文本读取 choices[0].message.content,并检查 choices[0].finish_reason。
- Chat Completions 的工具调用位于 choices[].message.tool_calls,不能与 Responses 的 output[].type=function_call 混读。
Request
请求
/v1/chat/completionsBody
必填路径、查询与 Header 参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|
Content-Type | Header | string | 是 | - | application/json |
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 是 | 必填。使用青云TOP API 的 API Key,保留 Bearer 后的空格。 | Bearer YOUR_API_KEY |
X-Forwarded-Host | Header | string | 否 | - | localhost:5173 |
Chat Completions 兼容协议
调用与返回说明
适合已经依赖 Chat Completions 的客户端和模型。新建 OpenAI 集成时优先确认模型支持 Responses API,再决定是否使用此兼容协议。
请求时注意
- model 和 messages 是基本必填项;tools、tool_choice、response_format 等能力参数按场景发送,不是所有模型都支持。
- 模型 ID 以 GET /v1/models 的返回为准。示例中的固定模型名只是格式示例,不代表当前账号一定可用。
- 对于新推理模型,优先使用 max_completion_tokens;max_tokens 是旧字段,且可能与推理模型不兼容。
返回时注意
- 非流式文本读取 choices[0].message.content,并检查 choices[0].finish_reason。
- Chat Completions 的工具调用位于 choices[].message.tool_calls,不能与 Responses 的 output[].type=function_call 混读。