Speed Key 录入与管理

“Key 管理”用于交付和维护本供应商的原厂凭证。供应商可以上传、筛选和删除自己的 Key；Key 上线到接收平台及真实渠道测试由平台管理员完成。

上传 Key

进入“Speed分发 → Key 管理”，点击“上传 Key”，按以下顺序填写：

1. 选择分类

   分类决定下游渠道类型、默认端点、凭证字段和可选模型。无法确定分类时，先向平台管理员确认，不要选择相近分类代替。

2. 核对端点地址

   端点由渠道分类预设，供应商端只读。显示“留空（官方默认）”表示接收平台将使用该渠道的官方默认地址。 如果需要专用代理、区域网关、私有部署地址，或发现预设地址与实际接入地址不一致，请联系平台管理员确认，不要在凭证内容中自行拼接地址。

3. 选择模型

   只勾选该批凭证实际开通的模型。可以在选择框中搜索，也可以使用“粘贴模型”批量加入已同步模型。

4. 录入凭证

   按页面显示的列逐行填写，或使用粘贴、CSV 和当前分类提供的批量能力。不同分类的字段数量和顺序可能不同。

5. 补充标识并提交

   按需填写标签、分组、备注和渠道名前后缀。提交后检查成功、重复和失败数量，并逐行处理失败项。

端点地址与特殊接入

端点地址属于渠道分类配置，不是单条 Key 的自由输入项。供应商端看到的地址可能有三种状态：

常见的特殊端点包括 Azure OpenAI 的资源地址、带区域变量的 AWS Bedrock 地址、企业代理网关和私有部署地址。管理员确认新地址后，通常需要重新导入受影响的 Key；分类默认端点的修改不会自动改写已经导入或已经上线的渠道。

常见资源类型录入

下面是当前 Speed 中最常见的录入形态。最终可选项以“分类”下拉中显示的已启用分类为准；同一种 new-api 类型可以因为资源来源不同而存在多个分类，字段以当前分类页面为准。

录入前建议按“一个资源入口 + 一组权限相同的模型”划分批次。不同区域、不同权限或不同端点的凭证不要混在同一批次中，便于管理员上线、测试和后续对账。

如果所需的资源类型或凭证模式不在分类下拉中，不要选择“最接近”的类型硬填。请向平台管理员提供以下信息，由管理员评估并新增或启用分类：

• new-api 渠道类型名称和数字类型编号（如已知）；
• 供应商官方 API 文档或端点说明；
• 凭证字段、字段顺序和是否需要 Region / Project / Account ID 等附加信息；
• 可调用的模型清单，以及是否需要特殊请求协议或鉴权 Header。

管理员新增分类后，刷新页面即可看到新的录入格式；已经导入的旧 Key 不会自动转换到新分类。

常见凭证模式

Vertex 服务账号

单个凭证可以上传一个 .json 文件或填写一个 JSON 对象；批量导入可以多选文件，也可以填写 JSON 对象数组。每个对象会生成一个独立 Key。

服务账号 JSON 至少需要：

• project_id
• client_email
• private_key
• type 如存在，值必须为 service_account

private_key 必须是完整 PEM 私钥，包含 BEGIN PRIVATE KEY 和 END PRIVATE KEY 标记。

部署区域支持两种写法：

us-central1

或按模型指定区域的 JSON 对象：

{
  "default": "us-central1",
  "gemini-2.5-pro": "global"
}

区域映射必须包含 default，模型名和区域值均不能为空。

AWS Bedrock

AWS Bedrock 支持两种凭证模式：

• AccessKey / SecretKey：每行填写 AccessKey、SecretKey、Region。
• Bedrock API Key：每行填写 API Key、Region。

若页面提供“批量上 Key”，可输入一套凭证并勾选多个区域，系统会按区域生成多行待导入数据。提交前仍需逐行核对区域。

模型和高级配置

模型选择

• 模型列表由平台从接收平台同步，供应商不能自行创建模型名。
• “粘贴模型”会跳过不在已同步清单中的名称。
• 同一批 Key 应选择相同的模型集合；模型权限不同的凭证建议分批上传。
• 分类没有可靠默认模型时，页面不会自动勾选，请按凭证真实权限选择。

渠道名称与高级配置

渠道名前缀、后缀、模型映射和系统提示词会在管理员上线时同步到下游渠道。没有明确联调要求时，保持默认或留空。

导入结果与状态

导入完成后，结果区会显示每一行的处理结果：

Key 列表状态含义：

• 库存：已录入，但尚未在任何接收平台在线。
• 已上线：至少有一个接收平台存在在线渠道。
• 已下线：曾上线，但当前已从接收平台下线。
• 上线平台数：当前在线的接收平台数量，不代表所有模型均已测试通过。

删除前检查

• 确认选中的是目标 Key，而不是同一批次中提示相近的其他凭证。
• 已上线的 Key 应先联系管理员下线，再执行删除。
• 删除不可恢复；需要再次使用时必须重新上传。
• 对外沟通只提供脱敏 Key 提示，不提供完整凭证。

Key 完成录入后，前往设置结算折扣。