上线验证 SOP

正式接入前，建议按下面的 SOP 验证一遍。

1. 账户与余额

• 可以登录 AkaRouter 控制台。
• 钱包余额大于本次测试预计消耗。
• API Key 已创建，并只保存在服务端环境变量中。

2. Endpoint

确认代码里的 Base URL 是：

https://api.akarouter.com/v1

不要把控制台地址、文档地址或支付地址写成 API Base URL。

3. 模型名

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

export AKAROUTER_MODEL="MODEL_FROM_CONSOLE"

不要使用未在控制台出现的模型名。

4. 最小请求

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

预期结果：

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

5. 错误重试

上线代码应区分错误类型：

• 401、402、403：先停止重试并报警。
• 429：降并发，指数退避重试。
• 502、503、504：短暂重试，并记录 Endpoint、模型名和响应体。

6. 工单材料

如果验证失败，提交工单时附上：

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