鉴权与 Key

所有接口都用 Key 鉴权:OpenAI 兼容接口放在 Authorization: Bearer sk-... 头里,Claude 入口用 x-api-key,Gemini 入口用 x-goog-api-key。一把 Key 可以调用模型库里对你可见的全部模型。

获取 Key

开通账号(目前采用邀请制)后进入控制台的 Key 页创建一把 Key。Key 以 sk- 开头,创建时可设置过期时间与额度上限;额度上限只是给这把 Key 单独设的封顶,花费仍从账户余额扣。每个账号还自动带一把名为 chat 的 Key,供试用对话页使用,计费方式与其他 Key 相同。

Key 可随时在控制台查看、禁用或删除,禁用即时生效;怀疑泄露时请立即禁用并新建一把。日常建议给每个项目单独一把 Key,并设额度上限与过期时间,出问题时按 Key 筛选用量就能定位。

约束

每把 Key 可以单独设四类约束。前两项在 Key 页直接设置,后两项目前只能通过控制台接口设置。

约束说明
过期时间到期后请求返回 401「令牌已过期」;到期前可在 Key 页修改。
额度上限用尽后返回 401「令牌额度已用尽」,与账户余额无关;不设即不限。
可用模型限制这把 Key 只能调用指定模型;调用其他模型时按「无可用渠道」处理,返回 503。目前只能通过控制台接口的 setting.limits.limit_model_setting 设置。
IP 白名单只允许列出的来源 IP 或 CIDR 段调用,其余返回 403。同样通过 setting.limits.limits_ip_setting 设置。
用接口创建带模型限制与 IP 白名单的 Key
POST https://inferstream.cn/api/token/
{
  "name": "prod-search",
  "expired_time": -1,
  "remain_quota": 684930,
  "unlimited_quota": false,
  "setting": {
    "limits": {
      "limit_model_setting": { "enabled": true, "models": ["deepseek-chat", "qwen-plus"] },
      "limits_ip_setting":   { "enabled": true, "whitelist": ["203.0.113.10", "10.0.0.0/8"] }
    }
  }
}

remain_quota 是内部额度单位(换算见计费),expired_time 是 Unix 秒,-1 表示永不过期。Key 本身没有独立的速率限制,限流规则见错误码与限流。

组织 Key

多个人共用一份余额时用组织:在控制台右上角切到组织上下文后创建的 Key 就是组织 Key,归组织所有而非创建者,从组织钱包扣费,不动任何人的个人余额;成员离开后 Key 仍存在,管理员可停用。调用方式与个人 Key 完全一样。

项说明
组织钱包充值、赠额都进这里;余额不足返回 402 insufficient_org_quota。
月度上限所有者或管理员可给每个成员设当月通过组织 Key 最多花多少,超出返回 402 org_monthly_limit_reached,次月自动清零;0 表示不限。
折扣运营给组织设的价格系数,只作用于组织 Key。
停用组织被停用后它的全部 Key 返回 403。
可见性所有者与管理员看全部成员的 Key 与用量,成员只看自己的。

限流上,组织 Key 同时受组织级与个人级规则约束。发票由所有者或管理员在组织上下文下申请,走组织的可开票金额;钱包、月度上限与发票的细节见计费。