查询结果

GET

https://api.mmchat.xyz/open/v1/image/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/image/result/' \
--header 'Authorization: Bearer {{METACHAT_API_KEY}}' \
--header 'Content-Type: application/json'

响应示例

{
  "status": "Success",
  "message": "绘图任务查询成功",
  "data": {
    "id": "830662445609029",
    "status": "success",
    "progress": 100,
    "fail_reason": "",
    "total_points": 350,
    "prompt": "年轻亚洲女性微笑着看着远方",
    "revised_prompt": null,
    "model": "grok-imagine-image-quality",
    "params": {
      "num": 1,
      "aspect": "1:1",
      "size": "2K"
    },
    "image_urls": [
      "https://mc-oss-cn.oss-cn-shanghai.aliyuncs.com/grok-imagine-8886b7de3a90.png"
    ],
    "submitted_at": 1780635249,
    "started_at": 1780635249,
    "finished_at": 1780635260
  }
}

修改于 2026-06-05 09:09:22

图像生成

视频生成