快速开始 - ByteSpike

1. 拿到一个 key

登录 console.bytespike.ai —— 注册大约 30 秒（邮箱 + 密码，或 Google 登录）。
在账单充值几块钱，最低充值金额为 $5。
进入 API keys，点击 创建 key。选一个路由分组（Claude 模型用 claude-default，Gemini 用 gemini-default，或用 default 路由全部模型 —— 各分组包含哪些模型见模型）。

复制创建后展示的密文。它形如 sk-byts-...，只显示一次 —— 找个安全的地方存好。

明文密钥只在创建时展示一次。如果丢失，可以在 Console → API keys 重新揭示，或者轮换 key 拿到新的密文。详见鉴权。

2. 选一个协议

ByteSpike 原生支持三种协议。同一个网关、相同的计费 —— 选你客户端能讲的那种鉴权头。

Anthropic Messages
OpenAI Chat Completions
Gemini Native

curl https://llm.bytespike.ai/v1/messages \
  -H "x-api-key: $BYTESPIKE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, who are you?"}]
  }'

curl https://llm.bytespike.ai/v1/chat/completions \
  -H "Authorization: Bearer $BYTESPIKE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5-5",
    "messages": [{"role": "user", "content": "Hello, who are you?"}]
  }'

curl "https://llm.bytespike.ai/v1beta/models/gemini-3.1-pro:generateContent?key=$BYTESPIKE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello, who are you?"}]}]
  }'

3. 读取配额响应头

每次响应 —— 无论成功还是失败 —— 都会带上网关的计费响应头：

X-RateLimit-Limit: 50.00
X-RateLimit-Remaining: 42.18
X-RateLimit-Reset: 1716705600
X-Quota-Remaining-Credits: 192.40

X-RateLimit-Limit / Remaining / Reset —— 当前最接近触发限制的那个速率窗口，单位 USD。Reset 是 Unix 时间戳。
X-Quota-Remaining-Credits —— 该 key 剩余的累计 credits（USD；1 USD = 1,000,000 credits）。0.00 意味着达到 key 上设置的 quota 上限；在 console 充值或提高上限即可。
X-Org-Quota-Remaining-Credits —— 在组织钱包级别的同一数值，仅对组织持有的 key 返回。

要查实际每次调用花费，请求 GET /v1/usage 或者比较两次请求之间 X-Quota-Remaining-Credits 的差值。失败的请求不计费 —— 非 2xx 响应不会让 X-Quota-Remaining-Credits 动。

4. 同一个 key 调用任意模型

切换模型只要改一个字段 —— model。无需新 SDK、无需新鉴权流程、无需新计费账户。

- "model": "claude-sonnet-4-6",
+ "model": "gpt-5-5",

- "model": "claude-sonnet-4-6",
+ "model": "deepseek-v4-pro",

- "model": "claude-sonnet-4-6",
+ "model": "gemini-3-1-pro",

注意点：你的 key 必须绑定到一个能实际服务该模型的路由分组。claude-default 触达不了 DeepSeek；在创建 key 时挑对分组，或者另建一把 key。Console 的 Test 按钮可以在你接入客户端之前先验证 key + 分组 + 模型三者匹配。图像 / 视频 / 工具端点的用法见 API 参考 —— 每个家族的请求结构都按端点单独写有文档。

下一步

鉴权

子 key、scope、IP 白名单。

Credits 与账单

credits 如何换算成美元，失败为什么不计费（真的不计费），以及如何读响应头。

​1. 拿到一个 key

​2. 选一个协议

​3. 读取配额响应头

​4. 同一个 key 调用任意模型

​下一步

鉴权

Credits 与账单

1. 拿到一个 key

2. 选一个协议

3. 读取配额响应头

4. 同一个 key 调用任意模型

下一步