查询结果 - MetaChat API

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

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

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

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

{ "status": "Success", "message": "FLUX.1 绘图任务查询成功", "data": { "id": "adbbe702b90a4d2cab10490d1f6de990", "status": "success", "progress": 100, "fail_reason": "", "total_points": 200, "prompt": "给这个女子带上墨镜", "revised_prompt": "Put sunglasses on this woman.", "model": "flux-kontext", "params": { "mode": "pro", "num": 1, "aspect": "1:1" }, "image_urls": [ "https://oss.com/111.png" ], "submitted_at": 1751476863, "started_at": 1751476863, "finished_at": 1751476887 } }

请求参数

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_urls

array[string]

最终生成的图像列表

可选

任务执行成功后返回。

total_points

integer

任务消耗的元点

可选

任务执行成功后返回。

prompt

string

原始提示词

必需

revised_prompt

string

最终生效的绘图提示词

可选

翻译提示词。

model

string

最终生效的模型版本

可选

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

params

object

最终生效的绘图参数

可选

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

submitted_at

integer

任务提交时间

必需

UNIX 时间戳（秒）。

started_at

integer

任务启动时间

可选

UNIX 时间戳（秒）。

finished_at

integer

任务结束时间

可选

UNIX 时间戳（秒）。