
在 Imagild API 控制台打开生成使用记录,选择相关密钥,再选择图片、视频或全部。通过任务标识、模型和创建时间找到任务,然后同时查看任务状态与计费状态。筛选列表有助于定位已经存在的操作,但不是账号余额每一次变化的完整账单。
请使用所属账号操作。控制台历史记录面向账号所有者,不是浏览其他用户任务的公开接口,也不能替代应用自身的权限检查。
要点
- 密钥和媒体筛选会缩小记录范围;判断任务缺失前,先重置筛选。
- 刷新记录读取已存历史,不会开始新的生成,也不会强制向上游模型发起状态查询。
- 预留中、已消费、已释放和未预留代表不同的记账状态,查看积分数值时需要结合这些状态。
尽量少作假设,找到原记录
- 登录集成所属账号,打开 API 控制台。
- 展开密钥表下方的生成使用记录。
- 根据密钥名称和脱敏前缀,选择目标密钥。
- 按需要将任务类型设为图片、视频或全部。
- 如果已知任务标识,先按它核对,再比较模型与创建时间。
- 使用加载更多记录查看更早的条目,并留意当前筛选条件。
密钥选择器使用的是控制台已经加载的密钥。如果其中缺少某个旧密钥,请在密钥管理区域选择加载更早的 Key,然后重新检查。密钥列表的历史加载和任务列表的分页,是两个独立的控制项。
不要把完整密钥粘贴到搜索框或支持消息中。密钥名称与脱敏前缀是运维标识,不是供应用通过身份验证的凭据。即使是这些有限信息,也只应提供给适当的接收者。
将任务状态与计费状态一起看
每条记录包含媒体类型、模型、创建时间、密钥名称与前缀、任务状态、积分和计费状态。通过任务 ID,将它关联到自己应用中的对应操作。
| 计费状态 | 如何理解该记录 | 不能据此推断什么 |
|---|---|---|
| 预留中 | 积分仍为该操作保留 | 任务已经完成,或积分已经释放 |
| 已消费 | 记录表明已发生完成生成的积分消耗 | 钱包的其他所有变动都属于这个任务 |
| 已释放 | 预留积分已经释放 | 一笔现金购买已经退款 |
| 未预留 | 记录未显示预留积分 | 请求的任务已免费成功完成 |
计费状态指南更详细地说明了生命周期。“预留中”旁边的积分代表为任务保留的额度,而同样的数值在“已消费”旁边具有不同含义。不要把列表中的所有数值直接相加,作为已经完成的总支出。
如实刷新一份已存观察记录
选择刷新记录,重新载入当前筛选下的历史。这一视图读取已经存储的任务信息,不会自行提交新的付费任务,也不会强制向模型提供方发起新请求。刷新列表后,未确定的状态仍可能保持未确定。
例如,假设某位操作人员找到一个密钥和创建时间都匹配的视频任务,但状态仍然未知,积分也仍在预留。正确记录应是“已找到原任务;结果仍待确认”。刷新三次列表,不会产生三笔扣费,也不能据此确认失败或授权创建替代任务。
如果集成需要获取一次最新任务状态,请遵循文档规定的、需要身份验证的任务读取流程及时间间隔要求。将新观察与此前保存的状态分开记录。访问失败和生成失败是不同事件。
结果为空时,先调查再考虑替代任务
清除密钥筛选,将媒体类型设为全部,再次查找已知任务 ID。确认账号是否正确、任务是否确实通过 API 受理,以及是否还有更早的记录尚未加载。API 历史视图并不承诺列出每一次编辑器操作或仅存在于工作台中的项目。
如果仍找不到任务,请保存原提交标识及最后收到的响应。不要仅为让列表出现一条新记录,就换一份密钥重新提交相同提示词。支持材料指南列出了有帮助的脱敏证据。
将找到的任务整理成可用的对账记录
在自己的私有记录中,将唯一任务 ID 与观察时间、密钥名称或前缀、模型、任务状态、积分和计费状态配对。明确这是你自己的应用记录;控制台并未承诺内置 CSV 导出或完整账号账本报告。
计算合计时,每个任务只采用一份最新观察记录。批量对账指南介绍了如何分开统计已消费积分与仍待确认的积分。实际下载媒体则属于另一流程,请参考按所有者权限导出媒体的指南;历史记录行不包含提示词或私人输出链接。
来源与适用范围
依据当前 Imagild API 控制台实现和已发布的集成指南编写,并于 2026 年 10 月 30 日核对。列表只展示账号所有者可见的有限元数据,不显示完整密钥、提示词、源文件或私人结果 URL。示例为假设情境;编写过程中未执行付费生成,也未访问客户历史记录。
由 Imagild Editorial编写,该公司编辑团队负责本系列指南。AI 参与了资料研究和起草。反馈更正。
封面:AI 生成的概念插图;并非应用截图、实测结果、私人账号记录或隐私保证。