查询任务

按 task_id 查一条任务的状态与结果。只能查最近 7 天创建的任务；成片链接限时，过期后重查即可拿到新链接。

GEThttps://api.maosika.com/v2/query/video_generation/{task_id}

路径参数

task_idstring必填

创建任务时返回的 task_id。

状态

状态含义
queued排队中，还没开始（此时可以取消）
running已提交给生成服务，正在出片
succeeded完成，content.url 可下载
failed失败，error 里有原因；预扣已退回
cancelled已取消；预扣已退回

响应字段

task.idstring

任务 id。

task.modelstring

你创建时发的模型名。

task.statusstring

见上表。

可选值: queued, running, succeeded, failed, cancelled

task.created_at / updated_atinteger

创建 / 最近更新的 Unix 时间戳（秒）。

task.content.urlstring

成片下载链接，仅 succeeded 时有；24 小时有效，重查续期。

task.resolutionstring

实际交付的分辨率（1080P 请求按 2K 交付）。

task.durationinteger

实际交付的时长（整数秒）。

task.ratiostring

生效的画幅（adaptive 已落到具体档）。

task.task_type / modalitystring

固定 generation / video。

可选值: generation / video

task.usageobject

仅 succeeded 时有：total_seconds、input_seconds（参考视频秒数）、output_seconds、input_image_count、input_audio_seconds。

task.errorobject

仅 failed 时有：code 与 message。

task.adjustmentsstring[]

我们的扩展字段：有降档时才出现，逐条写明改了什么。

轮询建议

  • 每 10 秒查一次足够；一条 5 秒片通常 2–4 分钟完成，15 秒片 6–9 分钟，30 秒片约 15 分钟。
  • 每把 Key 每分钟最多 300 次请求；超过会收到 429 和 Retry-After。
  • 用 callback_url 可以省掉轮询：状态一变我们就推给你。
Request
curl --request GET \
  --url https://api.maosika.com/v2/query/video_generation/1789383217076969 \
  --header 'Authorization: Bearer <your api key>'
Response
{
  "task": {
    "id": "1789383217076969",
    "model": "MiniMax-H3-Max",
    "status": "succeeded",
    "created_at": 1789383217,
    "updated_at": 1789383412,
    "content": {
      "url": "https://api.maosika.com/v2/files/1789383217076969/video.mp4?expires=1789469812&sig=…"
    },
    "resolution": "720P",
    "duration": 5,
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video",
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0,
      "input_audio_seconds": 0
    }
  }
}

文档目录