API Keys 说明

API Key 是你调用 Mirrorstages API 的凭证。每个 Key 除了承担身份认证的职责外，还直接决定了费用的扣减方式。请在创建时根据使用场景合理配置。

创建 API Key

1. 登录 Mirrorstages 控制台
2. 进入 API Keys 页面
3. 点击 创建 API Key
4. 为 Key 设置一个易于识别的名称（如 claude-code-mac）
5. 选择是否绑定套餐（详见下方 计费绑定 部分）
6. 复制并安全保存生成的 Key

注意

API Key 仅在创建时显示一次，请立即保存。如果遗失，需要重新创建。

计费绑定

创建 API Key 时，你可以选择绑定套餐或不绑定套餐，两者的计费逻辑不同。

绑定套餐

将 Key 绑定到某个已购套餐后，该 Key 产生的所有消费都从套餐内余额中扣减，不会动用账户余额。当套餐余额耗尽时，该 Key 的请求将自动返回失败，不会产生额外费用。

绑定后不可变更

API Key 一旦绑定套餐，暂不支持解绑或更换为其他套餐。请在创建前确认所绑定的套餐。如需变更，请删除当前 Key 并重新创建。

不绑定套餐

如果创建时不绑定任何套餐，该 Key 的消费将从账户余额中按量扣减。实际扣费金额为：

$$\text{费用}=\text{使用量（Token）}\times \text{模型价格}\times \text{账户倍率}$$

这种方式更灵活，适合用量不固定或希望多个 Key 共享同一余额池的场景。

两种方式对比

对比项	绑定套餐	不绑定套餐
扣费来源	套餐内余额	账户余额
超额保护	套餐余额耗尽自动停止	账户余额耗尽后停止
计费方式	以套餐定价为准	用量 × 模型价格 × 账户倍率
变更灵活性	绑定后不可变更	无限制
适用场景	预算隔离、固定用途	灵活共享、按需使用

使用 API Key

在请求中通过 Authorization 头传递 API Key：

curl https://api.mirrorstages.com/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-6-20250514", "messages": [{"role": "user", "content": "Hello"}]}'

或在 SDK 中设置：

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.mirrorstages.com/v1"
)

管理 API Key

查看 Key 列表

在控制台的 API Keys 页面可以看到所有已创建的 Key，包括：

• Key 名称与绑定状态
• 创建时间
• 最后使用时间

删除 Key

如果某个 Key 不再使用或存在泄露风险，请立即删除。删除后该 Key 的所有请求将立即失效。

安全建议

建议	说明
不要硬编码	使用环境变量存储 Key，避免写入代码
定期轮换	建议定期更换 API Key
最小权限	为不同用途创建不同的 Key
及时清理	删除不再使用的 Key

推荐通过环境变量管理 API Key：

export MIRRORSTAGES_API_KEY="your-api-key"

然后在代码中读取：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MIRRORSTAGES_API_KEY"],
    base_url="https://api.mirrorstages.com/v1"
)