日志与异步任务

平台将请求明细、绘图记录和视频、音乐等异步任务分别保存。登录后，可以从左侧导航进入「使用日志」或「任务日志」。本页统一说明三个数据分区、任务状态和接口查询方式。

三个分区对应以下路径：

/usage-logs/common：通用 API 使用日志和计费明细；
/usage-logs/drawing：Midjourney 绘图任务；
/usage-logs/task：Suno、视频等通用异步任务。

使用日志

在左侧边栏点击「使用日志」或访问 /usage-logs/common 查看 API 请求和计费明细。

筛选记录

筛选项	说明
时间范围	按记录创建时间筛选，起止时间都包含在查询范围内。
模型名称	按模型名称筛选。
分组	按请求使用的分组筛选。
日志类型	所有类型、充值、消耗、管理、系统、错误、退款、登录。
令牌名称	按 API 密钥名称筛选。
请求 ID	按平台请求 ID 定位一次请求。
上游请求 ID	按上游服务返回的请求 ID 定位请求。反馈问题时附上这个 ID，排查会快很多。

页面统计

筛选栏中的统计值会跟随当前筛选条件变化：

Usage：当前筛选范围内消费记录的额度合计，可按时间、模型、分组和密钥等条件查看。
RPM：最近 60 秒内的消费请求数。
TPM：最近 60 秒内的输入 Token 与输出 Token 总数。

列表与详情

列表包含时间和类型、令牌、模型、流、Tokens、费用、耗时和详情等列。

Tokens：显示输入 Token / 输出 Token；使用缓存时还可能显示缓存读取和写入数量。
费用：显示该条记录的额度消耗或退款结果。
耗时：对有计时数据的消费或错误记录显示响应耗时；流式请求可能额外显示首字响应时间（FRT）和吞吐信息。
详情：点击记录可打开详情对话框。根据日志类型和记录中实际保存的字段，可能包含请求 ID、模型映射、错误或退款原因、Token 明细、计费明细、缓存/音频/图片用量、流状态等，不是每条记录都会显示全部区块。

为什么看不到某条记录

日志写入有短暂延迟，刚发出的请求可能要过几秒才出现，先刷新页面再确认。

并非每个失败响应都会生成 Error 记录：在请求到达模型之前就被拦下的情况（例如密钥无效、额度不足），通常不会产生消费日志。

个人资料中的「记录 IP 地址」偏好只影响消费日志和错误日志里是否保存请求 IP，不影响记录本身是否生成。

任务日志

「任务日志」包括「绘图日志」和「任务日志」两个子分区：

绘图日志：记录 Midjourney 绘画任务。
任务日志：记录文生视频、图生视频、音频生成等异步任务。

绘图日志

在左侧边栏点击「任务日志」→「绘图日志」或访问 /usage-logs/drawing 查看 Midjourney 绘图任务记录。

绘图日志支持按以下条件筛选：

日期范围；
Midjourney 任务 ID。

列表包含提交时间和状态、操作类型、任务 ID、耗时、提交结果、进度、图片、提示词和失败原因。点击图片可打开预览；点击提示词可查看完整内容；点击失败原因可查看完整错误信息。

绘图状态包括：未启动、队列中、执行中、成功、失败、窗口等待。

异步任务日志

在左侧边栏点击「任务日志」→「任务日志」或访问 /usage-logs/task 查看异步任务日志。

视频、音乐等异步接口不会在提交请求时立即返回最终结果。提交成功后，平台会返回对外公开的任务 ID，并保存任务记录，再由后台轮询上游服务并更新状态、进度和结果。

筛选任务

任务日志支持按以下条件筛选：

日期范围；
任务 ID。

列表与结果

任务列表显示提交时间和完成时间、任务 ID、平台与操作、耗时、状态、进度和详情：

Suno 任务成功且返回音频地址时，详情列提供音频预览；
部分视频任务在成功后会显示预览入口；也可以使用同一账号的登录会话或 API 密钥请求 /v1/videos/{task_id}/content 获取已完成任务的视频内容。该接口会校验任务归属，任务未完成或不属于当前用户时不会返回内容；
其他失败记录会在详情列显示失败原因，点击后可查看完整信息。

任务状态与后台处理

异步任务日志使用以下状态值。不同平台返回的状态写法可能略有差异，通过接口读取时建议做兼容处理。

状态	含义
未启动	任务记录已创建，但尚未开始处理。
队列中	已提交到上游，等待后续处理。
排队中	已进入处理队列。
执行中	正在处理。
成功	已完成，可以查看或获取结果。
失败	处理失败；失败原因会写入任务记录（如果上游提供）。
未知	内部定义的未知状态兜底值。

任务状态由后台轮询更新，约每 15 秒检查一次，因此刚提交的任务会有短暂延迟。用接口查询任务结果时，请按这个节奏设置轮询间隔，不要用高频循环请求。长时间没有完成的任务会在超时后转为失败终态。

失败、超时与退款

任务进入失败终态后，若任务有提交阶段预扣的额度，系统通常会尝试退还，并在退款成功时写入一条「退款」日志。退款成功后会清除任务记录中的待退款额度，并回减累计用量；请求次数不会因此回退。

以下情况可能导致页面状态与余额暂时不一致：

任务本来就没有预扣额度（费用显示为 0）；
退款暂时没有成功，系统会保留该额度以便重试或人工对账。这种情况请保留任务 ID 联系客服。

接口参考

日志查询接口

如果你想把用量接入自己的对账或监控系统，可以调用以下只读接口。接口使用登录态认证，返回结果始终限定为当前账号。

数据	接口	时间参数单位
通用日志	`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 和 page_size；页码从 1 开始，超过 100 的 page_size 会被截为 100。

另外，GET /api/log/token 可以直接用 API 密钥读取该密钥最近的日志，无需登录态，适合在服务端做用量自查；最多返回最近 1000 条记录。密钥过期或额度耗尽都不影响这个查询。

GET /api/task/self 的常用查询参数：p、page_size、task_id、start_timestamp、end_timestamp，也接受 platform、action、status。

任务接口的 start_timestamp、end_timestamp 使用 Unix 秒时间戳；Midjourney 绘图接口的时间参数使用毫秒。

异步生成与任务接口

以下接口用于提交和查询视频、音乐、绘图等异步任务，均使用 API 密钥认证。视频内容接口也接受登录会话，并会校验任务归属，只返回属于你自己的任务内容。

具体支持哪些平台取决于当前开通的模型，可在模型广场按模型类型筛选确认。

接口	路径	说明
OpenAI 视频生成	`POST /v1/videos`	创建 OpenAI 兼容的视频生成异步任务，成功后返回任务标识。
OpenAI 视频任务查询	`GET /v1/videos/{task_id}`	查询视频生成任务的状态、进度和结果信息。
视频内容获取	`GET /v1/videos/{task_id}/content`	将已完成视频内容流式返回；系统会按任务结果从上游获取内容或解码已保存的 data URL。
视频 Remix	`POST /v1/videos/{video_id}/remix`	基于已有视频提交新的 Remix 异步任务。
旧版视频生成	`POST /v1/video/generations`	兼容旧版视频生成路径，创建异步视频任务。
旧版视频任务查询	`GET /v1/video/generations/{task_id}`	查询旧版视频生成任务状态和结果。
Kling 文生视频	`POST /kling/v1/videos/text2video`	使用 Kling 格式提交文本生成视频任务，系统会先执行请求格式转换。
Kling 图生视频	`POST /kling/v1/videos/image2video`	使用 Kling 格式提交图像生成视频任务。
Kling 任务查询	`GET /kling/v1/videos/text2video/{task_id}` `GET /kling/v1/videos/image2video/{task_id}`	查询 Kling 文生视频或图生视频任务结果。
即梦官方接口	`POST /jimeng/`	兼容即梦官方 API 格式，通过 `Action`、`Version` 等参数区分提交任务和查询操作。
Suno 任务提交	`POST /suno/submit/{action}`	提交 Suno 音乐生成任务，具体任务类型由 `action` 参数决定。
Suno 任务查询	`POST /suno/fetch` `GET /suno/fetch/{id}`	查询 Suno 任务列表或指定任务的状态和结果。
Midjourney 任务提交	`POST /mj/submit/{action}` `POST /{mode}/mj/submit/{action}`	支持 `imagine`、`describe`、`blend`、`change`、`simple-change`、`edits`、`video`、`action`、`modal` 和 `shorten` 等任务操作。
Midjourney 任务查询	`GET /mj/task/{id}/fetch` `GET /mj/task/{id}/image-seed` `POST /mj/task/list-by-condition`	查询任务状态、图像种子或按条件查询任务列表；也支持带 `{mode}` 前缀的路径。
Midjourney 图片代理	`GET /mj/image/{id}` `GET /{mode}/mj/image/{id}`	根据 Midjourney 任务 ID 获取或代理生成的图片。
Midjourney 扩展操作	`POST /mj/insight-face/swap` `POST /mj/submit/upload-discord-images`	提供换脸和上传 Discord 图片等扩展功能。

与数据看板的关系

日志是逐条明细，数据看板是按时间、模型和分组聚合后的统计。两者的刷新时机不同：新请求先出现在日志中，图表数据要等聚合后才更新，所以短时间内两边对不上是正常的。

排查一次调用时，建议先在使用日志中按时间、模型、Request ID 或 Upstream Request ID 定位请求；异步请求则记录提交接口返回的 task_id，再查询任务最终状态和失败详情。需要联系客服时，附上请求 ID 或任务 ID 是最快的方式。