model。跨能力类型或使用模型专属参数时,仍需调整接口与请求体。POST /v1/chat/completions。基础字段为 model 和 messages;普通文本消息的 content 使用字符串。text、image_url 的内容数组。图片输入能力与图片生成能力不同。输入图片的格式、大小、可访问性和数量限制应以目标模型要求为准。stream、采样参数、最大输出长度、工具调用和思考相关扩展字段均需要目标模型支持。不要把某一模型的扩展参数直接套用到其他模型。GET /v1/models 查询自己的 Key 可用的完整模型 ID。以下差异适用于对应已开放模型,不代表所有分组都有这些模型,也不代表其他同名路由具有完全相同能力。| 模型 ID | 思考模式 | 输入 |
|---|---|---|
| deepseek-v4.1-flash | enabled/disabled 可选 | 文字、图片 |
| deepseek-v4-flash-202605 | enabled/disabled 可选 | 文字 |
| deepseek-v4-pro-0813 | enabled/disabled 可选 | 文字 |
| deepseek-v4-pro-202606 | enabled/disabled 可选 | 文字 |
| deepseek/deepseek-v4-flash-vision-exp | enabled/disabled 可选 | 文字、图片 |
| glm-5.2 | enabled/disabled 可选 | 文字 |
hy4-preview | 默认开启,可选 enabled/disabled | 文字 |
| glm-5.3 | 固定思考,不能关闭 | 文字 |
| glm-5.3-flash | 固定思考,不能关闭 | 文字 |
"thinking":{"type":"enabled"} 开启,改为 "disabled" 关闭。平台不强制覆盖客户选择;省略字段时采用模型默认行为。两个固定思考模型建议省略 thinking,不要用 disabled 期望关闭。https://zhuanqicloud.com/v1,扩展字段放在 extra_body:choices[0].message.content,思考内容读取 reasoning_content。思考 tokens 也占输出预算并计入输出用量;max_tokens 过小可能只有思考、没有最终答案。流式时分别读取 delta.content 和 delta.reasoning_content,收到 [DONE] 后结束。需要末尾用量可设置 stream_options:{"include_usage":true};未返回 usage 时不要自行补零。hy4-preview 使用相同的 POST /v1/chat/completions,输入为文字。先通过 GET /v1/models 确认自己的Key可见该模型。默认开启思考;显式传 "thinking":{"type":"disabled"} 关闭,enabled 开启。thinking 必须是对象,thinking.type 仅接受这两个值;off、on 等其他 枚举返回400,并定位 error.param,不会静默采用默认思考继续调用。{
"model": "hy4-preview",
"messages": [{"role": "user", "content": "解释二分查找。"}],
"thinking": {"type": "disabled"},
"max_tokens": 1024
}https://zhuanqicloud.com/v1,HY4扩展参数放入 extra_body={"thinking":{"type":"disabled"}};JavaScript/TypeScript请求中的 thinking 在请求体顶层。开启思考时,max_tokens 同时限制思考和最终回答;预算耗尽可能返回 finish_reason:"length",正文尚未生成。模型上下文1024K、最大输入960K、最大输出64K是能力上限,不是平台自动补充的预算。message.content,思考内容读取实际存在的 message.reasoning_content。流式请求用 "stream":true,"stream_options":{"include_usage":true},分别读取 delta.content 与 delta.reasoning_content;在含用量的帧读取 usage,收到 [DONE] 后结束。没有usage时不补零。tool_choice 既可以是 "auto"、"none"、"required",也可以是指定函数对象;函数名必须在 tools 中声明:{
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "查询城市天气",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
"additionalProperties": false
}
}
}],
"tool_choice": {"type": "function", "function": {"name": "get_weather"}}
}tool_calls 及实际存在的 reasoning_content,追加 {"role":"tool","tool_call_id":"对应调用id","content":"工具结果字符串"}。DeepSeek的强制工具限制不直接套用于HY4。response_format:{"type":"json_object"} 及已通过的简单JSON Schema案例。提示中同时说明JSON字段,并按目标Schema校验响应;一个简单Schema通过不代表所有关键字均被支持。usage.completion_tokens 是输出总量,reasoning_tokens 是其中明细,不能再加一次计费。HY4若收到超出输出总量的思考子计数,平台省略该异常子项并留存诊断,输入、输出总量与扣费不变;子项缺失不代表思考用量为零。缓存命中读取实际返回字段,不用最终答案字数推算用量。{
"model":"deepseek-v4.1-flash",
"messages":[{"role":"user","content":[
{"type":"text","text":"请描述图片。"},
{"type":"image_url","image_url":{"url":"https://example.com/picture.png"}}
]}],
"thinking":{"type":"disabled"},
"max_tokens":1024
}data:image/png;base64,...。不要提交本地路径或需要登录的网页。使用 Vision 模型时将 model 替换为 deepseek/deepseek-v4-flash-vision-exp。response_format:{"type":"json_object"},同时在消息中明确要求 JSON;当前不支持严格 json_schema。其他模型高级参数以模型详情为准,不要直接套用。thinking:{"type":"enabled"} 或 disabled;thinking必须是对象。固定思考两款收到disabled返回HTTP400,错误字段为thinking.type。DeepSeek/GLM各款不要用enable_thinking,也不要混用thinking与reasoning_effort;平台不静默修改客户选择。tool_choice:"required" 或指定函数对象,此组合返回400并定位tool_choice。强制工具必须显式关闭思考;auto/none不受此项校验限制,但开启思考+auto本次不作为完整工具能力承诺。tools使用OpenAI函数定义,客户端校验并执行函数;下一轮保留assistant消息(含tool_calls,及实际返回的reasoning_content),追加 {"role":"tool","tool_call_id":"对应调用id","content":"工具执行结果"}。不要把函数参数当作可直接执行的命令。/v1/messages 思考开关及等价行为不在承诺范围内,不能以返回200证明完整兼容。数学或事实关键业务应校验结果;Pro-202606关闭思考已有小样本算术错误,建议思考开启或计算工具,不代表平台可修复模型权重。$NEW_API_KEY 是Bash环境变量名,应先在本地设置平台Key;PowerShell用 $env:NEW_API_KEY,Python用 os.environ["NEW_API_KEY"]。不要将变量名当真实Key,不要把真实Key写入共享脚本。POST /v1/embeddings。通用请求包含 model 与 input,其中 input 可按模型能力使用单条文本或文本数组。data[].embedding 为向量,data[].index 用于对应输入顺序。批量条数、输入长度和向量维度限制因模型而异;只有支持自定义维度的模型才能使用 dimensions 等可选参数。POST /v1/rerank。提交 model、query 和候选文本数组 documents,按 results[].relevance_score 读取相关性结果,并通过 results[].index 对应原始候选文档。top_n、return_documents 等为可选字段,支持范围和默认行为以目标模型及平台适配为准。客户端应保留原始候选数组,不依赖响应一定返回文档正文。POST /v1/images/generations。 基础请求包含 model 和 prompt。size、n、response_format 以及其他高级字段受模型能力限制,不能把某个示例中的尺寸、张数上限或返回格式当作平台统一承诺。响应可能通过 data[].url 或 data[].b64_json 提供图片,客户端应按实际返回处理。POST /v1/audio/speech。通用请求包含 model、input 和目标模型支持的 voice。VOICE_ID 或其他占位符不能直接调用,也不存在文档统一保证可用的 default 音色。输出格式、语速范围与输入长度限制因模型而异。Content-Type 保存或播放,不要将音频内容按 JSON 解析;失败时则检查 HTTP 状态与错误响应。POST /v1/audio/transcriptions,通过 multipart/form-data 上传 file 并指定 model。使用客户端的表单上传功能自动生成 boundary,不要手动把 multipart 请求头写成不带 boundary 的固定字符串。text 返回识别内容;若使用目标模型支持的 response_format: text,应按纯文本响应处理。service@zhuanqicloud.com 或 zhuanqicloud@gmail.com 联系支持人员。