Skip to main content
POST
Query task status

查询任务

使用提交响应中的 Wizzx task_id,并携带同一个 API Key。推荐使用 RESTful GET /api/v1/task/{task_id}(也支持 GET /api/v1/task/status?task_id={task_id} 或 POST /api/v1/task/status)。三种方式都只读取已保存的任务状态,不会再次向 Provider 提交任务。
或使用 POST:
客户端可见状态为 PENDING、QUEUED、PROCESSING、REVIEW_REQUIRED、SUCCEEDED、FAILED。内部 DISPATCHING 会以 PROCESSING 返回。 非终态继续查询同一个 Task ID。遇到未知状态、REVIEW_REQUIRED 或提交结果不明确时,不得自动创建替代任务。若任务失败且预留积分已退回(或未实际扣费),credits_deducted 返回 0。

响应

成功的任务在 result_urls 中列出生成的媒体。所有模型的该字段保持不变。

音乐结果

已完成的音乐任务还会返回结构化的 result 对象。返回哪些字段取决于动作;没有值的字段会被省略。其他模型不返回 result。
  • 曲目保持原有顺序,即使某首曲目没有 audio_url(例如 upload 之后)。
  • 音乐任务的 result_urls 依次列出每首曲目的 audio_url、download 文件和音乐视频。歌词、BPM、MIDI 等文本与分析结果没有 URL,请从 result 读取。
  • 媒体 URL 通常由 cdn.wizzx.ai 提供。若复制到 CDN 失败,会返回原始 URL,该地址可能过期,请及时下载需要保留的结果。
  • 2026 年 10 月 15 日之前完成的音乐任务没有 result。

授权

Authorization
string
header
必填

Wizzx API key. This is not a JWT.

请求体

application/json
task_id
string<uuid>
必填

Wizzx task ID returned by submit.

响应

Current task state

code
enum<integer>
必填
可用选项:
0
message
string
必填
示例:

"success"

data
object
必填
request_id
string<uuid>
必填