查询结果

GET

https://api.mmchat.xyz/open/v1/video/result/{id}

查询视频生成任务的执行进度和结果。

当任务状态（status）为 submitted（排队中）、in_progress（执行中）时，调用方可定时轮询（考虑生成速度，建议周期不低于 5 秒），最长不超过 30 分钟，如果超时后任务仍处于上述状态，调用方可直接判定为任务失败。

当任务状态（status）为 failure（执行失败，具体原因参见 fail_reason）、success（执行成功）时，任务结束，调用方可获取结果，无需继续轮询。

请求参数

Path 参数

Header 参数

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.mmchat.xyz/open/v1/video/result/' \
--header 'Authorization: Bearer {{METACHAT_API_KEY}}' \
--header 'Content-Type: application/json'

响应示例

{
  "status": "Success",
  "message": "视频任务查询成功",
  "data": {
    "id": "b366e967-7bbc-9935-a4d4-5642b65e26c1",
    "status": "success",
    "progress": 100,
    "total_points": 3550,
    "prompt": "女子的表情悲伤，脸上有泪痕，开始奔跑",
    "revised_prompt": "女子的表情悲伤，脸上有泪痕，开始奔跑",
    "model": "grok-imagine-video-1.5-preview",
    "params": {
      "duration": 5,
      "ratio": "adaptive",
      "resolution": "720p"
    },
    "video_url": "https://mc-oss-cn.oss-cn-shanghai.aliyuncs.com/5c687dac4df8a74cd.mp4",
    "thumb_url": "https://mc-oss-cn.oss-cn-shanghai.aliyuncs.com/thumb-1780603035003.webp",
    "submitted_at": 1780603002,
    "started_at": 0,
    "finished_at": 1780603037
  }
}

修改于 2026-06-05 09:13:45

视频生成

接入说明