Documentation Index
Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
Use this file to discover all available pages before exploring further.
令牌（API KEY）是什么
令牌就是您调用 API易 时使用的 API KEY，格式以sk- 开头。它是您身份和权限的凭证，主要作用包括：
身份认证
每次 API 调用都需要携带令牌，用于验证您的身份和账户。
额度与权限控制
可为单个令牌设置专属额度、过期时间、可用模型和分组。
调用统计
每个令牌的消耗、剩余额度、调用日志都可独立查看。
灵活分配
可为不同项目、团队成员创建独立令牌，便于管理和隔离。
注册后系统会自动生成一个默认令牌，开箱即用。您也可以按需创建多个新令牌。
如何创建令牌
进入令牌页面
打开顶部导航的「令牌」页面：https://api.apiyi.com/token
编辑令牌与查看代码示例
点击令牌最右侧「操作」列的管理菜单（扳手图标），即可展开全部操作：
| 操作 | 说明 |
|---|---|
| 禁用令牌 | 临时停用该令牌，调用将被拒绝 |
| 编辑令牌 | 修改名称、额度、有效期、计费模式、分组等 |
| 请求示例 | 查看代码示例，提供该令牌的多语言调用代码（curl、Python 等），复制即用 |
| 令牌日志 | 查看该令牌的调用记录 |
| 分享令牌 / 一键对接 | 快速分享或对接到第三方工具 |
「请求示例」即代码示例入口。点击后会带上当前令牌生成可直接运行的调用代码，无需手动拼接 KEY 和接口地址，适合快速测试和接入。
什么是分组
分组是令牌可选择的”资源通道”。 不同分组对应不同的上游资源、可用模型范围和计费倍率，开放给用户自行选择。 简单理解：同一个模型可能由多条上游通道提供，分组就是让您选择走哪条通道。不同的模型可能需要用到不同的分组，选对分组才能正常调用并享受对应的折扣。绝大多数情况下使用**默认分组（Default）**即可，它模型齐全，覆盖文本模型、NanoBanana 系列、Veo 3.1 等绝大部分模型。
默认分组与兜底分组
同一个令牌最多可设置 3 个分组：1 个默认分组 + 2 个兜底分组。默认分组（主分组）
令牌优先使用的分组，通用绝大部分模型。每个令牌必须有 1 个默认分组。
兜底分组（备用）
当默认分组无法满足请求时自动切换的备用通道，最多可设置 2 个，提高调用成功率。
- 选择分组：设置默认（主）分组，默认为
Default - 兜底分组：可添加 1~2 个备用分组，当主分组不可用时自动兜底
不同模型对应不同分组
默认分组通用绝大部分模型，但部分模型（尤其是视频模型）需要切换到专属分组才能调用：| 模型 / 场景 | 需要选择的分组 |
|---|---|
| 文本、多模态、NanoBanana、Veo 3.1 等绝大部分模型 | Default（默认分组） |
| Sora 2 官转视频 | Sora2Official |
| 阿里 Wan 视频系列 | Wan |
分组一览
下图为系统提供的分组及说明（以控制台实际显示为准）：
表格中的「组倍率」为人民币计价的相对值，并非直接的美元折扣比例，无需深究。您只需选择与所用模型匹配的分组即可；想了解倍率与价格的换算，请参考 系统里模型的【倍率】是什么？。
相关文档
令牌计费模式
了解按量优先、按次优先等计费模式的区别。
令牌模型白名单
如何限制单个令牌可用的模型范围。
模型倍率说明
理解倍率含义与价格计算规则。
调用日志查询
查看每个令牌的调用记录与消耗明细。