快速开始

第一步：注册账号

访问 shotject.com 并注册账号。注册后自动获得一个免费额度，可用于测试平台上的所有模型。

第二步：创建 API Key

登录后进入控制台，在 API Key 页面创建一个新的 Key：

Key 以 sk- 开头，创建后请妥善保存（关闭页面后不再展示完整 Key）。
可以在 API Key 中限定允许调用的模型白名单，为空则表示允许所有模型。

第三步：选择模型

在 /models 页面查看当前可用的模型列表及其价格。

每个模型有一个唯一的 Model ID（如 gpt-5.5、claude-sonnet-4-8-20260601），在 API 请求的 model 字段中使用。

第四步：发起第一次调用

Chat Completions（OpenAI 兼容）

curl https://shotject.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Messages（Anthropic 兼容）

curl https://shotject.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-8-20260601",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

流式调用

在请求体中设置 "stream": true 即可启用 Server-Sent Events (SSE) 流式响应。

响应头

每次请求会在响应头中返回以下信息：

响应头	说明
`X-Shotject-Channel`	调用来源：`official`（官方渠道）或 `byok`（自带密钥）
`X-Shotject-Fallback`	是否发生了 BYOK→官方回落：`true` 或 `false`