📜 日志与异步任务
查看 API 请求、绘图和异步任务记录，按条件筛选明细并跟踪状态、结果与退款。
平台将 API 请求明细、绘图记录与音视频等长耗时异步任务分类存储，便于开发者快速排障、精确对账与回溯结果。
控制台提供三个专属日志分区：
/usage-logs/common：通用 API 调用明细与 Token 计费日志；/usage-logs/drawing：Midjourney 绘图任务日志与图片结果；/usage-logs/task：Suno 音乐、视频等异步生成任务日志。
用户日志严格受权限隔离，普通开发者仅可查看当前账号发起的请求记录与任务结果。
使用日志
在左侧边栏点击「使用日志」或直接访问 /usage-logs/common 查看 API 请求与计费明细。
筛选记录
| 筛选项 | 说明 |
|---|---|
| 时间范围 | 按请求创建时间筛选，支持自定义起止日期。 |
| 模型名称 | 输入模型关键字，快速定位指定模型的调用频次。 |
| 分组 | 按请求实际路由的渠道分组进行筛选。 |
| 日志类型 | 包含全部类型、消耗、充值、错误、退款等。 |
| 令牌名称 | 按 API 密钥名称筛选，精准核算各开发环境的消耗。 |
| 请求 ID | 输入平台生成的唯一 Request ID 定位单次请求。 |
| 上游请求 ID | 输入模型提供商返回的原始 Request ID。 |
实时指标看板
筛选栏顶部提供实时吞吐与消耗指标：
- Usage：当前筛选条件下的总额度消耗统计；
- RPM（Requests Per Minute）：最近 60 秒内的并发请求速率；
- TPM（Tokens Per Minute）：最近 60 秒内的 Token 吞吐速率（输入 Token + 输出 Token）。
列表与详情
日志列表直观展示调用时间、模型、消耗额度、提示 Token、补全 Token 及响应耗时。点击单条日志可展开查看请求头、详细报错信息及上下文快照。
绘图日志
在左侧边栏进入 /usage-logs/drawing，查看 Midjourney 等图像生成任务明细。
- 展示提示词（Prompt）、提交时间、耗时、执行进度与状态；
- 生成完成后可直接在列表内预览图片，并支持一键放大（Upscale）、变换（Variation）等后续操作。
异步任务日志
在左侧边栏进入 /usage-logs/task，集中跟踪视频生成（Sora / Kling / 即梦）、Suno 音乐等长耗时异步任务。
任务状态说明
| 状态 | 详细含义 |
|---|---|
| 排队中 / 队列中 | 任务已成功提交至生成队列，等待算力调度。 |
| 执行中 | 上游生成引擎正在渲染生成，已可查询进度百分比。 |
| 成功 | 任务已完成，可在控制台预览或通过 API 获取下载链接。 |
| 失败 | 生成失败，详情列提供上游返回的具体错误原因。 |
异步任务状态通常由系统后台每 15 秒轮询更新一次。因大模型视频/音频渲染耗时较长，请耐心等待状态刷新。
失败、超时与自动退款
异步任务若因上游服务受阻或超时导致最终失败：
- 若任务在提交阶段预扣了额度，系统会在确认失败后自动全额退还预扣配额；
- 退款成功时，系统会在通用使用日志中自动记录一条「退款」明细，并将额度返还至原账户余额或订阅配额中。
接口参考
只读日志查询 API
除控制台外，开发者可通过 API 直接拉取调用日志实现自动化对账：
| 数据类型 | 用户只读端点 | 时间参数单位 |
|---|---|---|
| 通用日志明细 | GET /api/log/self | 秒 (created_at) |
| 日志统计摘要 | GET /api/log/self/stat | 秒 |
| Midjourney 绘图日志 | GET /api/mj/self | 毫秒 (submit_time) |
| 异步任务日志 | GET /api/task/self | 秒 (submit_time) |
端点支持标准分页参数 p（页码，从 1 开始）与 page_size（单页条数，最大 100）。
异步生成与任务端点
| 接口类型 | 路径 | 功能说明 |
|---|---|---|
| 视频生成 | POST /v1/videos | 提交异步视频生成任务，返回 task_id。 |
| 视频任务查询 | GET /v1/videos/{task_id} | 查询生成进度与结果 URL。 |
| 视频流式获取 | GET /v1/videos/{task_id}/content | 流式代理获取已生成的视频二进制内容。 |
| Kling 文生视频 | POST /kling/v1/videos/text2video | Kling 协议文生视频任务提交。 |
| Kling 图生视频 | POST /kling/v1/videos/image2video | Kling 协议图生视频任务提交。 |
| Suno 音乐任务 | POST /suno/submit/{action} | 提交 Suno 音乐创作任务。 |
| Suno 状态查询 | GET /suno/fetch/{id} | 获取生成音频播放地址与歌词。 |
| Midjourney 任务 | POST /mj/submit/{action} | 提交 Imagine、Blend、Describe 等任务。 |
| Midjourney 查询 | GET /mj/task/{id}/fetch | 查询 Midjourney 任务状态与图片结果。 |
与数据看板的关系
- 日志：逐条记录的原始请求流水，包含每一次调用的毫秒级耗时、报错和精确 Token。
- 数据看板：按时间周期（日/周/月）、模型类型和 API 密钥进行聚合统计的宏观趋势图。
- 建议：遇到单次调用异常或计费疑问时，优先使用「使用日志」根据 Request ID 定位排查；评估整体用量与选型成本时，参考「数据看板」。
这篇文档对您有帮助吗？