5 分钟上手

从注册到完成第一次模型调用，5 分钟。

1. 注册账号

打开 primerouter.ai 点 Sign Up，可用：

• 邮箱 + 密码
• GitHub / Discord / LinuxDO 等 OAuth 一键登录

新账号默认有少量赠送配额，足够你跑通第一条请求。

2. 充值（可跳过）

如果赠送配额够用就跳过这步。需要更多配额时：

• 加密货币（推荐）：在 控制台 → 充值 选链选币，复制专属地址转账，链上确认后自动到账。详见 加密支付。
• 信用卡 / Apple Pay：通过 Stripe 网关。
• 兑换码：在 控制台 → 兑换 输入码。

3. 创建 API key

控制台 → 令牌 → 新建：

• 名称：随便取一个
• 模型限制：可不填（默认所有模型可用）
• 过期时间：可不填（默认永不过期）

保存后复制 sk-... 开头的字符串——这是唯一一次显示完整 key 的机会，丢了只能重建。

4. 第一次调用

最简单的 curl 示例：

curl https://primerouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

预期响应类似：

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "deepseek-chat",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 28,
    "total_tokens": 40
  }
}

usage 字段与上游官方返回字节一致，账单按这个数字结算。

5. 查看用量与账单

控制台 → 日志：每条请求一行，可点开看：

• 上游供应商 / 模型
• token 用量
• 实际扣费金额
• trace-id（与响应 header 中的一致）

到这里，你已经完成了 primerouter 的最小闭环。

下一步

• 第一次调用 — 流式 / 多模态 / 工具调用
• 从 OpenAI SDK 迁移 — 各语言示例
• API 文档 — 完整接口说明
• 编程工具接入 — Claude Code / Codex / Cursor 等一键接入