API 充值

API 充值页面在系统中显示为「令牌中心」，用于管理模型调用余额、API 令牌、资源包、操作流水和调用日志。它是开发者对接平台模型能力前必须使用的页面。

访问入口：https://jingyun.studio/zh/token

一、充值账户余额

1. 进入 API 充值页面。
2. 打开「令牌管理」页签。
3. 点击「金额充值」。
4. 选择或输入充值金额。
5. 按弹窗提示完成支付。
6. 支付成功后，账户余额会刷新。

余额用于模型 API 调用和部分算力能力扣费。充值前可以先到 算力市场 查看模型价格，估算需要充值的金额。

二、创建 API 令牌

API 令牌用于外部系统调用平台模型接口。

1. 在「令牌管理」页签点击「新建令牌」。
2. 填写令牌名称，例如“生产环境调用”“测试脚本”。
3. 设置令牌状态，通常选择启用。
4. 设置过期时间：永久、7 天、30 天或自定义时间。
5. 设置金额额度，或勾选不限金额。
6. 选择可用模型；留空代表支持所有可用模型。
7. 点击确认创建。
8. 创建成功后立即复制并保存令牌。

令牌创建后用于请求页面展示的模型调用 URL。建议不同系统、环境或客户使用不同令牌，方便后续禁用和排查。

三、管理已有令牌

令牌列表会展示名称、状态、过期时间、金额、令牌、可用模型和创建时间。

常用操作：

建议将生产环境令牌设置为长期有效但限制模型和额度，将测试令牌设置为短期有效，避免泄露后造成持续消耗。

四、限制可用模型

创建或编辑令牌时，可以选择该令牌允许调用的模型。

使用建议：

1. 外部系统只需要文本模型时，不要开放所有模型。
2. 视频、图像等高成本模型建议单独创建令牌。
3. 多个客户或项目分别创建令牌，避免共用一个无法追踪的 Key。
4. 不确定模型名称时，先到算力市场查看模型列表。

留空模型限制时，令牌通常可调用账号权限内所有模型。正式生产环境不建议长期使用无限制令牌。

五、查看资源包

资源包页签展示当前生效中的账号包，例如多平台绑定账号包。

1. 切换到「资源包」。
2. 查看当前有效账号数。
3. 查看资源包名称、账号数、购买时间、到期时间和备注。
4. 如需新增，点击「购买账号包（年）」。
5. 购买成功后刷新资源包和操作流水。

账号包通常用于多平台发布、账号绑定等运营场景。它和 API 余额不是同一类资源，不要混淆。

六、查看操作流水

操作流水用于查看插件使用、账号包购买等平台侧操作记录。

1. 切换到「操作流水」。
2. 使用类型筛选查看全部、插件使用或账号包相关记录。
3. 查看时间、类型、详情、状态和备注。
4. 如果出现失败记录，查看备注中的错误信息。

操作流水适合排查某个运营插件是否执行成功，例如关键词挖掘、媒体发布或账号包购买。

七、查看调用日志

调用日志展示最近的模型调用记录。

1. 切换到「调用日志」。
2. 查看调用时间、类型、模型、消耗金额/额度和详情。
3. 使用上一页/下一页翻看记录。
4. 对照外部系统请求时间排查消耗来源。

调用日志主要用于费用核对和接口排错。如果外部系统出现异常高消耗，应先禁用相关令牌，再根据调用日志定位来源。

八、注意事项

1. API 令牌等同于调用凭证，不要发布到前端代码、公开仓库或截图中。
2. 生产环境建议为不同业务分别创建令牌，并设置模型范围和额度。
3. 删除或禁用令牌会导致使用该令牌的外部系统调用失败。
4. 余额不足时，模型调用可能失败。
5. 调用日志有延迟或分页限制时，以后台最终账单和流水为准。
6. 账号包是运营资源，不等同于模型调用余额。

九、常见问题

API 充值和算力市场是什么关系？

算力市场查看模型和价格，API 充值负责充值余额、创建令牌和查看调用消耗。

为什么令牌创建后看不到明文？

出于安全考虑，令牌通常默认隐藏。可点击显示或复制按钮获取，但应及时保存到安全位置。

外部系统调用失败怎么办？

检查令牌是否启用、是否过期、余额是否充足、模型是否在允许范围内，以及调用 URL 是否正确。