查询结果

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

Body

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

{
    "status": "Success",
    "message": "绘图任务查询成功",
    "data": {
        "id": "adbbe702b90a4d2cab10490d1f6de990",
        "status": "success",
        "progress": 100,
        "fail_reason": "",
        "total_points": 25,
        "prompt": "美丽的女子在街边微笑",
        "model": "z-image-turbo",
        "params": {
            "size": "1MP",
            "aspect": "9:16"
        },
        "image_urls": [
            "https://oss.com/111.png"
        ],
        "submitted_at": 1751476863,
        "started_at": 1751476863,
        "finished_at": 1751476887
    }
}

修改于 2026-01-27 21:06:33

图像生成

接入说明