简短回答
个人访问令牌是新版控制台推出的「管理接口凭证」,用来让脚本或自动化工具调用余额查询、日志查询、令牌管理这类接口。 它取代原来的系统令牌:可以只勾选需要的权限、设置到期时间、限定 IP 白名单,一个账号最多可建 20 个,按用途分开发放。个人访问令牌不能调用模型。调用模型请继续使用 API Key(控制台里叫「模型密钥」,
sk- 开头)。与系统令牌有什么不同
如何创建
1
打开个人访问令牌
登录控制台,进入个人中心
api.apiyi.com/account/profile,在「账户选项」里点击 个人访问令牌,再点右上角 创建令牌。2
填写名称与到期时间
名称按用途写,方便日后识别,例如「对账脚本」「余额监控」。到期时间默认 30 天,到期后令牌自动失效,建议选久一点(如 365 天),免得脚本突然中断。
3
设置 IP 白名单(可选)
多个地址用英文逗号分隔,支持 IPv4、IPv6 或 CIDR,留空表示不限制。白名单创建后不能修改,做法见下文。
4
勾选权限
只勾你的脚本用得到的权限,对照表见下文。
5
创建并保存令牌
点击 创建令牌,立即复制并妥善保存。



该勾选哪些权限
权限分为「读取」「写入」「查看密钥」三种,相互独立:勾了写入不等于能读取,勾了读取也看不到密钥明文。
例如只做每日对账,勾「用量与个人记录 · 读取」一项就够了;余额监控只勾「个人资料 · 读取」。
修改密码、两步验证这类需要安全验证的操作,仍须登录网页完成,个人访问令牌勾了写入也做不了。
IP 白名单怎么设才不踩坑
白名单创建后不能修改,要改只能新建一把。推荐的顺序:- 先建一把不填白名单的令牌,把脚本调通。
- 确认能用后,再建一把带白名单的正式令牌。把可能用到的出口 IP 都填上:生产服务器、备用服务器、需要临时排查时用的办公网络等。
- 换上正式令牌,删除那把不带白名单的测试令牌。
怎么调用
用法与系统令牌完全相同:请求头Authorization 填令牌本身,加不加 Bearer 前缀都可以。
常见报错
相关文档
余额查询 API
用个人访问令牌查询账户余额
日志查询 API
按时间段拉取调用明细做对账
令牌管理 API
程序化创建、轮换和删除 API Key
如何安全地管理 API Key?
API Key 的权限边界与防泄漏