API 接入
开始接入
- 在用户中心创建 API Key。
- 把 Key 安全注入服务端环境变量
API_KEY。 - 调用
/v1/models选择当前可用模型。 - 按快速接入发送第一条请求。
认证安全
数据 API 使用 Authorization: Bearer $API_KEY。不要把 Direct API Key 放入浏览器、移动应用、Git、镜像、日志或错误报告。
迁移与兼容
可参考从 OpenAI SDK 迁移和从 Anthropic SDK 迁移。协议兼容不代表模型行为完全一致，迁移后应重新验证输出和错误处理。
超时、限速与重试
为连接、首字节和完整请求分别设置合理超时。收到 429 时遵守退避策略；重试 POST 请求时应使用明确的幂等策略。
排查问题时保留 HTTP 状态、安全错误码和 X-Request-Id，不要记录 Prompt 或 Response。