客户端验收记录

这份页面用于记录 11API 试营业前的客户端跑通证据。没有完成至少 3 个客户端，不建议公开投放。

验收标准

每个客户端至少记录：

1. 验收日期和操作人
2. 使用的 New API 测试 Token，不使用真实客户 Token
3. base URL
4. 模型名称
5. 请求类型
6. 成功响应截图或日志位置
7. 费用是否出现在 New API 用量记录里
8. 失败时的错误码、上游和修复动作

机器可读验收文件

上线总闸门会读取服务器上的：

/opt/11api/deploy/runtime/client-acceptance.json

生产首选自动采集：

cd /opt/11api/deploy
./scripts/collect-client-acceptance.sh

脚本会用 NEW_API_TEST_TOKEN 跑通 OpenAI-compatible chat/responses/embeddings、Cursor Responses API、Claude-compatible messages 和 Claude Code x-api-key，然后生成：

runtime/client-acceptance.json
runtime/client-acceptance/*-summary.json

摘要文件只保存 endpoint、模型、HTTP 状态、usage、usageTotalTokens 和 responseSha256，不保存测试 Token，也不保留原始模型响应。

需要人工补充截图或工单链接时，可以复制模板：

cd /opt/11api/deploy
cp static/ops-templates/client-acceptance.example.json runtime/client-acceptance.json
vim runtime/client-acceptance.json

正式试营业前，至少保证：

1. cursor、claude-code、cherry-studio 都是 status=passed
2. 每个客户端都有 baseUrl、model、requestTypes 和 evidence
3. 每个客户端 usageVerified=true
4. 每个本地 summary 证据都有 usageVerified=true、usageTotalTokens>0 和 responseSha256
5. summary.passedCount>=3
6. summary.readyForFirstUsers=true
7. summary.blockers=[]

evidence 可以写截图路径、日志文件、证据包内文件名或内部工单链接，但不要写真实客户 Token。

Codex

日期：
操作人：
Base URL：https://api.11api.top/v1
测试 Token：
模型：
请求类型：OpenAI-compatible chat / responses
成功证据：
费用记录：
异常记录：
结论：通过 / 不通过

验收命令示例：

curl -fsS https://api.11api.top/v1/chat/completions \
  -H "Authorization: Bearer $NEW_API_TEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Say 11API ok in one short sentence."}],
    "max_tokens": 32
  }' | python3 -m json.tool

Claude Code

日期：
操作人：
Base URL：https://api.11api.top
测试 Token：
模型：
请求类型：Claude-compatible messages / x-api-key bridge
成功证据：
费用记录：
异常记录：
结论：通过 / 不通过

配置示例：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-...",
    "ANTHROPIC_BASE_URL": "https://api.11api.top"
  }
}

验收命令示例：

curl -fsS https://api.11api.top/v1/messages \
  -H "x-api-key: $NEW_API_TEST_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-haiku-latest",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Say 11API Claude ok."}]
  }' | python3 -m json.tool

Cherry Studio

日期：
操作人：
Provider 类型：OpenAI Compatible
Base URL：https://api.11api.top/v1
测试 Token：
模型：
请求类型：chat / embedding
成功证据：
费用记录：
异常记录：
结论：通过 / 不通过

Cherry Studio 中建议先配置一个低成本模型，再配置一个 embedding 模型，分别发送一条短文本和一次向量请求。

Cursor

日期：
操作人：
Provider 类型：OpenAI Compatible
Base URL：https://api.11api.top/v1
测试 Token：
模型：
请求类型：chat
成功证据：
费用记录：
异常记录：
结论：通过 / 不通过

Cursor 是试营业最低要求之一，至少要验证 OpenAI Compatible 的聊天或 Composer 请求能走 https://api.11api.top/v1 并在 New API 用量里出现。

验收结论

Codex：
Claude Code：
Cherry Studio：
Cursor：

是否满足“至少 3 个客户端跑通”：是 / 否
是否可以邀请首批用户：是 / 否
阻塞项：