Skip to main content

简短回答

个人访问令牌是新版控制台推出的「管理接口凭证」,用来让脚本或自动化工具调用余额查询、日志查询、令牌管理这类接口。 它取代原来的系统令牌:可以只勾选需要的权限、设置到期时间、限定 IP 白名单,一个账号最多可建 20 个,按用途分开发放。
旧系统令牌计划于 2026-11-11 (UTC+8) 停用。 停用后,用系统令牌调用管理接口会返回 401。 平台会根据实际使用情况决定是否延期,但建议尽早换成个人访问令牌:只需替换请求头 Authorization 里的值,代码不用改。
个人访问令牌不能调用模型。调用模型请继续使用 API Key(控制台里叫「模型密钥」,sk- 开头)。

与系统令牌有什么不同

如何创建

1

打开个人访问令牌

登录控制台,进入个人中心 api.apiyi.com/account/profile,在「账户选项」里点击 个人访问令牌,再点右上角 创建令牌。
2

填写名称与到期时间

名称按用途写,方便日后识别,例如「对账脚本」「余额监控」。到期时间默认 30 天,到期后令牌自动失效,建议选久一点(如 365 天),免得脚本突然中断。
3

设置 IP 白名单(可选)

多个地址用英文逗号分隔,支持 IPv4、IPv6 或 CIDR,留空表示不限制。白名单创建后不能修改,做法见下文。
4

勾选权限

只勾你的脚本用得到的权限,对照表见下文。
5

创建并保存令牌

点击 创建令牌,立即复制并妥善保存。
个人中心「账户选项」里的个人访问令牌入口 创建个人访问令牌:名称、到期时间、IP 白名单与权限 到期时间可选 30 天、90 天、180 天、365 天、自定义时间或永不过期

该勾选哪些权限

权限分为「读取」「写入」「查看密钥」三种,相互独立:勾了写入不等于能读取,勾了读取也看不到密钥明文。 例如只做每日对账,勾「用量与个人记录 · 读取」一项就够了;余额监控只勾「个人资料 · 读取」。 修改密码、两步验证这类需要安全验证的操作,仍须登录网页完成,个人访问令牌勾了写入也做不了。
一个脚本一把令牌、只勾它用到的权限。哪天某个脚本不用了或令牌泄漏,删掉那一把即可,不影响其它脚本。

IP 白名单怎么设才不踩坑

白名单创建后不能修改,要改只能新建一把。推荐的顺序:
  1. 先建一把不填白名单的令牌,把脚本调通。
  2. 确认能用后,再建一把带白名单的正式令牌。把可能用到的出口 IP 都填上:生产服务器、备用服务器、需要临时排查时用的办公网络等。
  3. 换上正式令牌,删除那把不带白名单的测试令牌。
填的是公网出口 IP,不是内网 IP。家用宽带、办公网络这类出口 IP 会变的环境不适合开白名单,可以改用只读权限加较短的到期时间来控制风险。

怎么调用

用法与系统令牌完全相同:请求头 Authorization 填令牌本身,加不加 Bearer 前缀都可以。
原来用系统令牌的脚本,把环境变量或配置里的值换成新令牌即可。

常见报错

相关文档

余额查询 API

用个人访问令牌查询账户余额

日志查询 API

按时间段拉取调用明细做对账

令牌管理 API

程序化创建、轮换和删除 API Key

如何安全地管理 API Key?

API Key 的权限边界与防泄漏