/api/v1/* 接口不同。
选择接入方式
不同模型和上游提供商支持的可选字段可能不同。调用前先使用
GET /api/v1/chatAiChatModels 获取 model_code、最大输出限制和当前应用单价；模型出现在目录中不代表它一定支持 Responses API。
服务端鉴权
两个对话接口直接使用应用APP_SECRET：
注意
只能从你的服务端调用大模型对话接口。不要把 APP_SECRET 放入浏览器 JavaScript、移动端安装包、URL、Storage、Cookie、日志或分析系统。文档页已关闭这两个接口的浏览器交互 Playground。
普通 /api/v1/* 业务接口仍使用 X-Legacy-Token，不要混用两套鉴权。
非流式与流式
stream 省略或设为 false 时，接口返回一次性 JSON。非流式成功响应还会带 X-Log-Id，可用于账单和故障定位。
stream=true 时，响应类型为 text/event-stream。客户端必须逐行读取 SSE 事件，不能等待整个响应结束后再按一个 JSON 解析。完整 cURL、Node.js 与 Python 示例见大模型对话示例。
Chat Completions 最小请求
model、messages[].role、messages[].content、stream、max_completion_tokens、max_tokens、兼容字段 max_output_tokens、temperature、top_p、tools、tool_choice、response_format 和 user。准确类型、中文说明和返回 Schema 见 API 参考中的“创建 Chat Completions 对话”。
Responses 最小请求
model、input、instructions、stream、max_output_tokens、兼容字段 max_completion_tokens 与 max_tokens、temperature、tools、previous_response_id 和 reasoning。上游不支持某字段时会返回兼容错误，不会由平台静默改写为其他能力。
错误处理
本地错误使用 OpenAI 风格对象：
上游非 2xx 响应会保留上游 HTTP 状态和响应体。你的客户端应允许上游增加错误字段，并避免把可能含提示词或业务数据的完整响应写入不受控日志。
流式响应开始后 HTTP 状态已经是
200。如果随后出现上游连接或代理异常，当前连接可能直接提前结束，并且不保证收到结构化 error 事件。客户端应把“未收到正常结束标记且连接中断”视为结果不完整；记录请求时间和本地追踪信息后，再根据业务是否允许重复生成决定是否重新提交。
计费与模型限制
- 模型目录中的价格单位是每 1000 Token 的平台计费单价。
- 非流式和流式请求都按上游返回的 Token 用量结算；模型不返回完整用量时按平台预扣与结算规则处理。
- 请求的输出上限不应超过模型目录中的
max_output_limit；为0时以模型实际限制为准。 tools、多模态输入、结构化输出和推理参数是否可用，以所选模型与上游提供商实际支持为准。