查询超分任务

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

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

路径参数

task_idstring必填

创建超分任务时返回的 task_id（与视频生成的 task_id 不通用）。

状态

状态含义
queued排队中，还没开始（此时可以取消，尚未扣费）
running处理中，progress 给出进度
succeeded完成，content.url 可下载
failed失败，error 里有原因；原视频被拒不扣费，其余情况已扣的费用全额退回
cancelled已取消，未扣费

响应字段

task.idstring

任务 id。

task.modelstring

固定 Maosika-Upscale。

task.statusstring

见上表。

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

task.created_at / updated_atinteger

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

task.resolutionstring

目标档位。

可选值: 720P, 1080P

task.task_type / modalitystring

固定 upscale / video。

可选值: upscale / video

task.sourceobject

来源：{"type": "video_url"}，或超分视频生成任务时 {"type": "task", "task_id": "…"}。

task.inputobject

原视频信息：width、height、duration（秒）、fps；读完原视频后才有。

task.outputobject

超分后的尺寸：width、height。

task.progressobject

仅 running 时有：done / total，done 等于 total 即将完成。

task.content.urlstring

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

task.usage.billable_secondsinteger

仅 succeeded 时有：billable_seconds，计费秒数（原视频秒数向上取整，最少 3 秒）。

task.errorobject

仅 failed 时有：code 与 message；code 见「创建超分任务 · 失败原因」。

轮询建议

  • 每 10–30 秒查一次足够。一条 15 秒的视频通常几分钟内完成，更长的视频按时长成比例增加。
  • 每把 Key 每分钟最多 300 次请求；超过会收到 429 和 Retry-After。
  • 用 callback_url 可以省掉轮询：状态一变我们就推给你（推送体就是这里的 task 对象）。
Request
curl --request GET \
  --url https://api.maosika.com/v2/query/video_upscale/1789390012345678 \
  --header 'Authorization: Bearer <your api key>'
Response
{
  "task": {
    "id": "1789390012345678",
    "model": "Maosika-Upscale",
    "created_at": 1789390012,
    "resolution": "1080P",
    "task_type": "upscale",
    "modality": "video",
    "source": {
      "type": "task",
      "task_id": "1789383217076969"
    },
    "status": "succeeded",
    "updated_at": 1789390150,
    "input": {
      "width": 854,
      "height": 480,
      "duration": 15.042,
      "fps": 24
    },
    "output": {
      "width": 1920,
      "height": 1080
    },
    "content": {
      "url": "https://api.maosika.com/v2/files/1789390012345678/upscaled.mp4?expires=1789476550&sig=…"
    },
    "usage": {
      "billable_seconds": 16
    }
  }
}

文档目录