4Z API

查询任务状态

接口: POST https://4zapi.com/suno/fetch

轮询入口之一。请求体为 task_id / clip id 列表(ids)。

注意:task_id 用于轮询任务;clip_id 用于续写/补段等,二者勿混用(API-Doc-Standards §2.4)。

根据任务 ID 列表批量查询任务或作品状态。

请求体 (application/json)

  • ids (array<string>, 必填): task_id 或 clip_id 列表
  • action (string): 可选;多数场景仅传 ids 即可

请求示例

{
  "ids": [
    "task_abc123"
  ]
}