接入检查清单

在把 回端AI 接入自己的产品或脚本前，可以用这份清单快速确认配置是否完整。

账号与余额

• 可以登录 回端AI 控制台。
• 钱包余额足够完成本次测试或业务调用。
• API Key 已创建，并只保存在服务端环境变量中。

API Base URL

代码里的 Base URL 应该是：

https://api.ai.retterm.cn/v1

不要把控制台地址、文档地址、支付地址或完整接口路径写成 Base URL。

模型名

从控制台「模型状态」复制模型名，并写入环境变量：

export RETTERMAI_MODEL="MODEL_FROM_CONSOLE"

不要使用未在控制台出现的模型名，也不要自行拼接供应商模型名。

最小请求

先用最小请求确认 Key、余额、Endpoint 和模型名都正确：

curl https://api.ai.retterm.cn/v1/chat/completions \
  -H "Authorization: Bearer $RETTERMAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$RETTERMAI_MODEL"'",
    "messages": [{ "role": "user", "content": "Return the word ok." }]
  }'

成功时应看到：

• HTTP 状态码为 200。
• 响应里包含 choices。
• 钱包余额或余额明细出现对应消耗。

错误处理

建议在你的代码里区分错误类型：

• 401、402、403：停止当前请求，检查 Key、余额或权限。
• 429：降低并发，使用指数退避重试。
• 502、503、504：短暂重试，并记录 Endpoint、模型名和错误响应。

需要支持时

如果仍然无法正常调用，请准备：

• 请求时间。
• Endpoint。
• 模型名。
• HTTP 状态码。
• 错误响应。
• 相关充值订单号或余额明细截图。

然后按 联系支持 的说明提交。不要发送 API Key、密码或支付私密信息。