快速开始

5 分钟跑通第一次 LLM 调用。

1. 创建组织并充值

注册账号 → 创建组织 → 在账单页通过 Stripe 充值。余额以预付费形式存入组织级钱包，组织成员共享同一个余额池。

2. 创建 API Key

进入 API Keys → 创建。Key 形如：

sk-tokenhouse_xxxxxxxxxxxxxxxxxxxxxxxx

Key 仅在创建时完整显示一次，请立即存入密码管理器——之后无法再次查看。

Key 撤销后立即失效，历史用量记录仍然保留。

3. 发起第一次请求

把 base URL 指向 TokenHouse，用你的 Key 作为 Bearer Token（Anthropic 原生的 x-api-key 头同样被接受）：

curl https://api.tokenhouse.ai/v1/chat/completions \
  -H "Authorization: Bearer <your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}]
  }'

返回为标准 OpenAI Chat Completions 结构：

{
  "id": "chatcmpl-9f3a1b2c",
  "object": "chat.completion",
  "model": "claude-sonnet-4-6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮你的？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

网关同时支持 Anthropic 协议（POST /v1/messages）与 OpenAI Responses 协议（POST /v1/responses），用同一个 Key 即可调用。

4. 列出可用模型

GET /v1/models（需鉴权）返回当前可调用的模型列表，OpenAI list 格式：

curl https://api.tokenhouse.ai/v1/models \
  -H "Authorization: Bearer <your-key>"

模型别名（如 claude-sonnet-4-6、glm-4.7）与规范键（如 anthropic.claude-*、zai.glm-*）两种写法都接受。完整模型列表见模型页，各模型费率见价格页。

流式调用

请求体加 "stream": true 即按 SSE 逐帧返回：

curl https://api.tokenhouse.ai/v1/chat/completions \
  -H "Authorization: Bearer <your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "讲个笑话"}],
    "stream": true
  }'

输出形如：

data: {"id":"chatcmpl-9f3a1b2c","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"好"}}]}
 
data: [DONE]

流式中断且已产生输出的请求，按已观测到的 token 数计费并标记 estimated；完全失败的请求不扣费。

常见问题

状态码含义处理
401鉴权失败检查 Authorization: Bearer（或 x-api-key）头与 Key 是否正确
402余额不足去账单页充值
400 unknown_model模型名不识别用 GET /v1/models 核对模型名

更多错误码与计费规则见错误码与计费。

下一步