数眼智能
首页常见问题
首页常见问题
  1. 海螺Hailuo视频生成
  • 快速开始
    • 平台简介
    • 控制台(入门)
    • API key
    • Base URL
  • 开发工具接入
    • OpenClaw
    • Claude Code
    • Claude Code IDE
    • Codex
    • OpenCode
    • Cline
    • Grok CLI
    • Gemini CLI
    • N8N
    • AutoClaw
    • 其他工具
  • AI大模型API
    • 文本生成API
      • 对话补全 Chat Completions
    • 官方接口视频生成API
      • 豆包Seedance视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-查询视频生成任务
        • 03-查询视频生成任务列表
        • 04-取消或删除视频生成任务
      • 海螺Hailuo视频生成
        • 00-概述
        • 01-文生视频-T2V
        • 02-图生视频-I2V
        • 03-首尾帧生成视频-FL2V
        • 04-主体参考视频-S2V
        • 05-查询任务状态
        • 06-视频下载
        • 07-附录-运镜指令与回调
      • 可灵AI视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-视频Omni
        • 04-多图参考生视频
        • 05-动作控制
        • 06-多模态视频编辑
        • 07-视频延长
        • 08-对口型
        • 09-数字人
        • 10-文生音效
        • 11-视频配音效
        • 12-语音合成
        • 13-音色克隆
        • 14-图像识别
        • 15-主体管理
        • 16-视频特效
      • Vidu视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-首尾帧
        • 05-智能多帧
        • 06-场景特效模板
        • 07-模板成片
        • 08-查询任务
      • 即梦视频生成
        • 00-概述
        • 01-3.0Pro视频生成
        • 02-720P文生视频
        • 03-720P图生视频-首帧
        • 04-720P图生视频-首尾帧
        • 05-720P图生视频-运镜
        • 06-1080P文生视频
        • 07-1080P图生视频-首帧
        • 08-1080P图生视频-首尾帧
        • 09-错误码
    • 通用视频生成API
      • 通用视频生成 API 接口调用文档
    • 通用图像生成API
      • 图像生成接口文档
    • Rerank重排序模型
      • 重排序
  • 搜索/阅读API
    • 网页阅读API
      • Web Reader API
    • 联网搜索API
      • 搜索API
      • 搜索+阅读API
    • 模态卡API
      • 天气
        • 天气模态卡
        • 国内外城市ID
        • 天气查询API
      • 搜索 API(旧)
      • 热搜 API
    • 文件OCR解析API
      • PDF文件
      • URL解析
  • 进阶与系统接口
    • CODE&错误码
    • HTTP注意事项
    • 身份验证
    • 接入指南
    • 在线调试
    • 数据更新相关
    • API 密钥与额度查询接口
    • Models(列出模型)
    • 查询账户信息
  1. 海螺Hailuo视频生成

05-查询任务状态

查询视频生成任务状态#

文档版本:v1.0.0 | 最后更新:2026-06-05
本平台已完整适配海螺(MiniMax / Hailuo)官方视频生成接口,请求与响应均为透传,参数语义与官方一致。
查询视频生成任务的当前状态。任务成功后返回 file_id,用于后续下载视频。
GET https://platform.shuyanai.com/hailuo/v1/query/video_generation

查询参数#

参数类型必填说明
task_idstring是待查询的任务 ID,只能查询当前账号创建的任务

请求示例#

响应示例#

{
  "task_id": "176843862716480",
  "status": "Success",
  "file_id": "176844028768320",
  "video_width": 1920,
  "video_height": 1080,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

响应字段#

字段类型说明
task_idstring被查询的任务 ID
statusstring (enum)任务当前状态,取值见下
file_idstring任务成功时返回,用于获取视频文件的文件 ID
video_widthinteger任务成功时返回,生成视频宽度(像素)
video_heightinteger任务成功时返回,生成视频高度(像素)
base_respobject通用响应状态(status_code / status_msg)

任务状态值#

状态含义
Preparing准备中
Queueing队列中
Processing生成中
Success成功
Fail失败
建议:采用轮询方式查询,建议轮询间隔不低于 10 秒,直至状态为 Success 或 Fail。
上一页
04-主体参考视频-S2V
下一页
06-视频下载