日志与异步任务

查看 API 请求、绘图和异步任务记录，按条件筛选明细并跟踪状态、结果与退款。

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

三个分区对应以下路径：

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

普通用户只能查看自己的记录。Admin 和 Root 可以在页面右上角切换「全部」与「仅自己」；切换为「仅自己」后，页面按普通用户的字段和权限返回数据。

使用日志

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

筛选记录

使用日志记录查询可用筛选项如下：

筛选项	说明
时间范围	按记录创建时间筛选，起止时间都包含在查询范围内。
模型名称	按模型名称筛选。
分组	按请求使用的分组筛选。
日志类型	所有类型、充值、消耗、管理、系统、错误、退款、登录。
令牌名称	按 API 密钥名称筛选。
请求ID	按 New API 请求 ID 定位一次请求。
上游请求ID	按上游服务返回或记录的请求 ID 定位请求。
用户名（仅Admin/Root）	在管理员视图中按用户名筛选。
渠道ID（仅Admin/Root）	在管理员视图中按渠道 ID 筛选。

页面统计

筛选栏中的统计值与当前权限和筛选条件相关：

Usage：汇总消费记录的额度，可根据时间、模型、分组、密钥、渠道和用户条件进行筛选。
RPM：最近 60 秒内的消费请求数。
TPM：最近 60 秒内的输入 Token 与输出 Token 总数。

列表与详情

普通用户可以看到时间和类型、令牌、模型、流、Tokens、费用、耗时和详情列。
Admin/Root 视图还可显示渠道和用户列。

使用日志页

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

为什么看不到某条记录？
消费日志是否写入受平台的「系统设置」 → 「运维」 → 「日志维护」 → 「记录配额使用量」开关控制，Root 关闭该设置后，新的消费记录可能不会产生。错误日志还受错误日志开关和可记录错误类型限制，并非每个失败响应都会生成 Error 记录。用户个人资料中的「记录 IP 地址」偏好只控制消费日志和错误请求日志是否保存请求 IP；登录、管理审计和充值等其他日志可能按各自的审计流程记录 IP。

任务日志

「任务日志」包括「绘图日志」和「任务日志」。

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

绘图日志

在左侧边栏点击「任务日志」 → 「绘图日志」或访问 /usage-logs/drawing 查看 Midjourney 绘图任务记录。
普通用户只能查看自己的任务；Admin/Root 可以在「全部」视图查看管理范围内的任务，并可额外查看渠道和提交结果。

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

日期范围；
Midjourney 任务 ID；
渠道 ID（仅Admin/Root）。

绘图日志页

列表包含提交时间和状态、渠道 ID（仅Admin/Root）、操作类型、任务 ID、耗时、提交结果、进度、图片、提示词和失败原因。点击图片可打开预览；点击提示词可查看完整内容；点击失败原因可查看完整错误信息。
绘图状态包括：未启动、队列中、执行中、成功、失败、窗口等待。
绘图状态由后台轮询上游任务更新。轮询存在间隔，任务状态可能存在延迟；当后台取得对应的上游任务数据时，系统会将已提交超过约 1 小时且仍未完成的 Midjourney 任务标记为失败。

任务日志（异步任务日志）

在左侧边栏点击「任务日志」 → 「任务日志」或访问 /usage-logs/task 查看异步任务日志。普通用户只能查看自己的任务；Admin/Root 视图还会显示渠道ID和用户。
视频、音乐等异步接口不会在提交请求时立即返回最终结果。提交成功后，New API 会返回对外公开的任务 ID，并保存任务记录，再由后台轮询上游服务并更新状态、进度和结果。

筛选任务

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

日期范围；
任务 ID；
渠道 ID (仅Admin/Root)。

列表与结果

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

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

任务状态与后台处理

异步任务日志使用以下状态值。不同平台适配器有时会保留上游状态的大小写或平台差异，因此接口返回值应以实际任务记录为准：

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

任务日志页

任务状态由后台轮询更新，刚提交的任务状态可能存在延迟。默认异步任务轮询约每 15 秒检查一次；轮询只会在 UPDATE_TASK 启用且存在未完成任务时运行。异步任务超时阈值由 TASK_TIMEOUT_MINUTES 控制，默认是 1440 分钟，设为 0 可禁用超时处理。

失败、超时与退款

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

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

任务没有预扣额度（quota = 0）；
资金来源退款失败，系统会保留任务额度以便重试或人工对账；

排查退款时，请同时查看钱包余额或订阅剩余额度（以及使用中的 API 密钥额度）和通用使用日志中的「退款」记录。不要仅根据「失败」状态判断退款是否已经完成。

接口参考

日志查询接口

如果使用 API 而不是控制台，可以调用以下只读接口。接口仍受认证和权限限制，普通用户的结果会强制限定为当前账号：

数据	管理员接口	用户接口	时间参数单位
通用日志	`GET /api/log/`	`GET /api/log/self`	秒（`created_at`）
日志统计	`GET /api/log/stat`	`GET /api/log/self/stat`	秒
Midjourney 绘图	`GET /api/mj/`	`GET /api/mj/self`	毫秒（`submit_time`）
异步任务	`GET /api/task/`	`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`。
Admin/Root	`GET /api/task/`	在用户接口参数基础上增加 `channel_id`，并可按 `platform`、`action`、`status` 筛选。

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

异步生成与任务接口

以下异步生成和上游任务查询接口由实例按已配置的渠道和适配器提供，提交与查询接口通常使用 API 密钥认证。视频内容代理同时支持 API 密钥或登录会话，并遵守任务归属校验；Midjourney 图片代理是无需 API 密钥的例外；下方的 /api/task 列表接口使用登录后的用户或管理员权限。具体认证方式以接口要求为准。

接口	路径	说明
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，再查询任务最终状态和失败详情。若任务长时间没有变化，检查渠道可用性、任务轮询开关、超时设置以及对应的「退款」日志。

日志与异步任务

目录