计费与支持
常见问题 FAQ
集中回答兼容性、模型、路由、密钥、流式输出、工具调用和计费问题。
这里汇总开发、迁移和上线阶段最常见的问题。
是否必须安装 Dimleap 专用 SDK？
不需要。Dimleap 兼容 OpenAI Chat Completions，可直接使用 OpenAI 官方 Python 或 Node.js SDK，也可使用任意 HTTP 客户端。
从 OpenAI 迁移需要改哪些代码？
通常只需把客户端的 Base URL 改为 https://api.dimleap.cn/v1，并换成 Dimleap API Key。如果原模型未以同名提供，再调整 model。
为什么模型标识正确仍返回参数错误？
不同模型支持的高级参数并不完全一致。移除可选参数进行最小化测试，再从模型广场确认工具调用、结构化输出、多模态等能力。
平台自动容灾后，我还需要重试吗？
需要保留有限的业务级重试，以处理所有可用路径均失败或网络中断的情况。但要限制次数和总超时，避免与 SDK 重试叠加造成过长等待。
为什么流式响应读取不到 message.content？
流式数据使用增量对象，应读取 choices[0].delta.content。某些块没有文本，需要安全处理空值。
函数调用会自动执行我的代码吗？
不会。模型只返回 tool_calls。你的应用负责校验参数、执行函数，并将结果以 role: "tool" 回传。
可以把 API Key 放在网页中吗？
不可以。任何发送到浏览器的密钥都可能被用户提取。请由自己的后端安全调用 Dimleap。
如何确认费用？
通过响应中的 usage 记录 Token 用量，并结合模型广场当前单价估算；最终结算以控制台账单为准。
如何获得最快的问题定位？
提交请求时间、时区、请求 ID、模型、状态码、SDK 版本和脱敏后的最小请求。不要发送完整 API Key。