查询结果 - MetaChat API

查询绘图任务的执行进度和结果。

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

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

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

{ "status": "Success", "message": "Midjourney 绘图任务查询成功", "data": { "id": "1749647995842056", "status": "success", "progress": 100, "fail_reason": "", "image_url": "https://example.com/xyz.png", "image_description": "", "total_points": 80, "prompt": "赛博朋克大都会", "revised_prompt": "Cyberpunk Metropolis. --aspect 1:1 --stylize 100 --quality 1 --chaos 0 --style raw --fast --v 6.1", "model": "mj-v61", "command": "IMAGINE", "params": { "aspect": "1:1", "stylize": 100, "exp": 0, "quality": 1, "chaos": 0, "style": "raw" }, "images": [ { "url": "https://aaa.bbb/yyy.jpg", "type": "image/jpeg", "size": 62294, "w": 750, "h": 750, "sw": 100, "sref": true } ], "submitted_at": 1749647996, "started_at": 1749647998, "finished_at": 1749648020 } }

请求参数

Path 参数

string

必需

各类图像生成、图像变换、图像处理 API 中成功创建的绘图任务 ID。

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

必需

API Key，请在 MetaChat 开通 API 套餐后，在设置 - API 页面中生成和查看。

示例值:

Bearer {{METACHAT_API_KEY}}

X-App-ID

string

必需

APP ID，请在 MetaChat 开通 API 套餐后，在设置 - API 页面中生成和查看。

示例值:

返回响应

🟢200成功

application/json

Body

status

string

API 调用结果

必需

Success 表示成功，Fail 表示失败。

message

string

描述信息

必需

通常用于结果为 Fail 时的错误信息。

data

object

API 返回数据

可选

当结果为 Fail 时 data 为空。

string

绘图任务 ID

必需

status

string

任务状态

必需

取值 submitted（排队中）、in_progress（执行中，具体进度参见 progress）、failure（执行失败，具体原因参见 fail_reason）、success（执行成功）。

progress

integer

任务进度（百分比）

必需

0 - 100。

fail_reason

string

任务失败原因

可选

任务执行失败后返回。

image_url

string

最终生成的图像 URL

可选

任务执行成功后返回。

image_description

string

图像描绘任务最终生成的提示词

可选

任务执行成功后返回。

total_points

integer

任务消耗的元点

可选

任务执行成功后返回。

prompt

string

原始提示词

必需

revised_prompt

string

最终生效的绘图提示词

必需

包括绘图描述、绘图参数、参考图和模型版本等信息。

model

string

最终生效的模型版本

必需

详见「图像生成」API 描述。

command

string

绘图任务指令

必需

params

object

最终生效的绘图参数

必需

详见「图像生成」API 描述。

images

array [object {12}]

原始参考图列表

必需

详见「图像生成」API 描述。

submitted_at

integer

任务提交时间

必需

UNIX 时间戳（秒）。

started_at

integer

任务启动时间

必需

UNIX 时间戳（秒）。

finished_at

integer

任务结束时间

必需

UNIX 时间戳（秒）。