上游账号与 API Key
上游账号
每个上游账号对应一个 AssemblyAI API Key,属性如下:
| 字段 | 说明 |
|---|---|
| 名称 | 便于识别 |
| 区域 | us 或 eu,决定请求发往 api.assemblyai.com 还是 api.eu.assemblyai.com 等 |
| 权重 | 选号时的相对概率 |
| 并发上限 | 该账号同时进行中的转写任务上限,达到后不再分配 |
| 代理 | 该账号访问 AssemblyAI 使用的网络出口,默认直连 |
| 状态 | 正常 / 冷却中(429)/ 异常(401、402、403,需要处理) |
导入
「导入」支持粘贴文本或上传文件,三种格式:
txt
# 每行一个:Key | 名称,Key | 名称,Key,区域,权重,并发,备注(逗号、Tab 或冒号分隔)
main,<AAI_KEY_1>,us,1,5
<AAI_KEY_2>csv
# 带表头的 CSV(含 key 或 api_key 列),可从导出文件直接再导入
name,key,region,weight,max_concurrency
main,<AAI_KEY_1>,us,1,5json
[{"name": "main", "key": "<AAI_KEY_1>", "region": "us", "weight": 1, "max_concurrency": 5}]重复的 Key 会自动跳过。导入后可勾选「导入后测试」。
批量操作
勾选账号后可以:测试、启用、停用、重置状态(清除冷却与异常)、设置代理、删除。「全部测试」会逐个调用 AssemblyAI 验证 Key。删除账号会同时删除它名下的任务记录。
导出
导出包含完整的上游 Key,请妥善保管导出文件。
API Key(对外 Key)
客户端调用 Hub 时使用的 Key,形如 hub- 加 43 位随机字符。
- 生成:可一次批量生成多个,生成后可随时在列表中查看和复制(加密存储)。
- 区域:给 Key 设置区域后,用它发起的请求只会分配到该区域的账号。
- 导入:
名称,完整Key每行一个,适合在多个环境保持相同的 Key。也可用环境变量HUB_API_KEYS。 - 停用 / 删除:立即生效,之后使用该 Key 的请求返回
401。 - 列表显示每个 Key 的请求次数和最后使用时间;按 Key 的用量见「用量」页。