MetaChat API
  1. 任务查询
MetaChat API
  • 概述
  • Midjourney
    • 接入说明
    • 模型价格
    • 图像生成
      • 图像生成
    • 图像变换
      • 图像拆分
      • 图像微调(四宫格)
      • 图像重绘
      • 图像高清
      • 图像微调(单图)
      • 图像变焦
      • 图像平移
    • 图像处理
      • 图像描述
      • 图像融合
    • 任务查询
      • 查询结果
        GET
  • FLUX.1
    • 接入说明
    • 模型价格
    • 图像生成
      • 图像生成
    • 任务查询
      • 查询结果
  • OpenAI
    • 接入说明
    • 模型价格
    • 聊天(Chat)
      • Chat Completions 对象
      • Chat Completions 对象块
      • 创建 Chat Completions
    • 图像(Images)
      • 图像对象
      • 图像生成
      • 图片编辑
  • Claude
    • 接入说明
    • 模型价格
    • 聊天(Messages)
      • 消息
  • Gemini
    • 接入说明
    • 模型价格
    • 文本生成
      • 文档理解
      • 文字输入
      • 图片输入
      • 流式输出
      • 多轮对话
      • 多轮对话(流式)
      • 配置参数
    • 图像生成
      • 使用 Gemini 生成图像
      • 使用 Gemini 编辑图像
      • 使用 Imagen 生成图像
  • DeepSeek
    • 接入说明
    • 模型价格
    • 普通聊天
      • 多轮对话
      • 对话补全
    • 推理聊天
      • 推理模型
  1. 任务查询

查询结果

开发中
GET
https://api.mmchat.xyz/open/v1/midjourney/result/{id}
查询绘图任务的执行进度和结果。
当任务状态(status)为 submitted(排队中)、in_progress(执行中)时,调用方可定时轮询(考虑绘图速度,建议周期不低于 5 秒),最长不超过 30 分钟,如果超时后任务仍处于上述状态,调用方可直接判定为任务失败。
当任务状态(status)为 failure(执行失败,具体原因参见 fail_reason)、success(执行成功)时,任务结束,调用方可获取结果,无需继续轮询。
请求示例请求示例
Shell
JavaScript
Java
Swift
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 参数
id
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 页面中生成和查看。
示例值:
{{METACHAT_APP_ID}}

返回响应

🟢200成功
application/json
Body
status
string 
API 调用结果
必需
Success 表示成功,Fail 表示失败。
message
string 
描述信息
必需
通常用于结果为 Fail 时的错误信息。
data
object 
API 返回数据
可选
当结果为 Fail 时 data 为空。
id
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 时间戳(秒)。
修改于 2025-06-17 10:53:35
上一页
图像融合
下一页
接入说明
Built with