最新Midjourney API，国内快速接入，轻松在自家产品上线AI画图功能 ...

MetaChat在最新的版本更新中，发布了Midjourney API，提供了生图、放大、微调等Midjourney的AI生图能力。笔者测试了一下，国内网络可以正常接入。
接入方式很简单：
首先注册MetaChat账号，打开MetaChat网站 https://metachat.fun ，注册成为会员。
其次，进入设置页面，找到充值入口，充值成功后，即会主动创建APPID和API Key。按照接口文档提供的接口描述，即可快捷调用Midjourney API。
Midjourney API
概述
MetaChat （ https://metachat.fun ) 面向合作伙伴提供开放平台 API，提供包罗 Midjourney 等 AIGC 模子的基础能力和扩展特性，供合作伙伴集成和二次开辟。本手册描述开放平台的接入方法、各类 API 的调用方法和注意事项，供合作伙伴的服务端开辟人员参考。

1、接入鉴权

MetaChat 开放平台提供服务端 HTTPS RESTful API 接口，服务端基础 URL 和 API 前缀如下：

https://api.mmchat.xyz/open/v1

调用 MetaChat 开放平台 API 时，需使用 MetaChat 为合作伙伴分配的应用 ID（App ID）和鉴权密钥（API Key）进行正当鉴权，具体方法：
在 HTTP Header 中填写 X-App-ID 字段，标识合作伙伴的应用 ID（App ID）。
在 HTTP Header 中填写尺度的 Authentication Bearer 字段，标识合作伙伴的鉴权密钥（API Key）。

1. 开放平台 API 参数格式为 JSON，请在 HTTP Header 中标识相应的 Content-Type，并注意请求参数的填写和响应参数的解析。
2. 以 curl 命令行工具调用为例：
4. curl https://api.mmchat.xyz/open/v1/models \
6.   -H "Content-Type: application/json" \
8.   -H "Authorization: Bearer $API_KEY" \
10.   -H "X-App-ID: $APP_ID"

复制代码

2、异常处置惩罚
MetaChat 开放平台 API 有如下两类异常返回：

服务级或应用级，利用 HTTP 尺度的 400/500 系列 status code 返回异常，此时无需剖析返回参数。
        401 - authentication_error: 鉴权失败，通常是 App ID 或 API Key 未填写或填写错误。
        403 - permission_error: 授权失败，通常是 App ID 或 API Key 已过期或已停用。
        404 - not_found_error: 哀求资源不存在，通常是 API path 填写错误。
        429 - rate_limit_error: 限流，通常是 API 调用太频繁。
        500 - internal_error: MetaChat 开放平台内部错误。

API 级，此时 HTTP status code 为 200，具体错误信息在返回参数中描述。
        status: API 调用效果，string 类型，Success 表现成功，Fail 表现失败。
        message：描述信息，string 类型，通常用于 Fail 时的错误信息。
        data: API 返回数据，object 布局，具体界说拜见后文 API 描述，当 Fail 时 data 为空。
示例：
{
        "status": "Fail",
        "message": "Midjourney 画图描述中存在错误的参数，请修改后重新提交。",
        "data": null
}
由于图片天生需要较长的 AI 服务时间，各图片天生和变动类 API 只负责创建和提交各类画图使命，使命执行进度和最终天生的图片效果，需要调用后文描述的「查询效果」API 获取。
API 阐明

---

Midjourney API

---

提供 Midjourney 官方支持的各类图片天生、变动、描述和融合能力，通常用于灵活多变的单一图片天生场景。
   由于图片天生需要较长的 AI 服务时间，各图片天生和变动类 API 只负责创建和提交各类画图使命，使命执行进度和最终天生的图片效果，需要调用后文描述的「查询效果」API 获取。
  
图片天生

---

POST /midjourney/imagine

• 阐明：根据提示词、参数和参考图，天生 1 张四宫格图片。
  
• 哀求参数（POST body）
  
  
  
  • prompt: 提示词，string 类型，必填，支持中英文。提示词末端可携带自界说参数（比方 --style raw --ar 1:1 --v 6 等），自界说参数会覆盖 params 中对应参数，未提供自界说参数时，以 params 参数为准。
    
  • model: 模子版本，string 类型，取值 mj-v6 (Midjourney V6，默认值)、mj-niji-v6 (Niji 6)。
    
  • params: 画图参数，object 类型
    
    
    
    • aspect: 图片比例，string 类型，取值 1:1（默认），2:3，3:2，3:4，4:3，16:9，9:16 等。
      
    • stylize: 风格化程度，number 类型，取值 1 - 1000（默认 100）。
      
    • quality: 画质，number 类型，取值 0.25（普通），0.5（标清），1（高清，默认）。
      
    • chaos: 混乱程度，number 类型，取值 0 - 1000（默认 0）。
      
    • style: 画图风格，string 类型，取值 raw。
      
    • seed: 随机种子，number 类型，取值 0 - 4294967295 间的整数。
      
    • no: 清除关键词列表，string 列表，支持中英文。
      
    • iw: 参考图权重，当参考图用于 Image Prompt 时有效，number 类型，取值 0 - 3（默认 1）。
      
    
    
  • images: 参考图参数，array 类型，可包含 1 - 3 张参考图（JPG/PNG/WebP 格式），每张参考图界说为 object 类型
    
    
    
    • url: 图片完整 URL，string 类型，必填，需确保访问该 URL 能正常下载图片文件。
      
    • type: 图片 MIME 类型，string 类型，必填，取值 image/png，image/jpg，image/jpeg，image/webp。
      
    • size: 图片文件大小，number 类型，图片文件大小（bytes）。
      
    • w: 图片宽度，number 类型。
      
    • h: 图片高度，number 类型。
      
    • image_prompt: 参考图是否用于 Image Prompt，boolean 类型。
      
    • sref: 参考图是否用于风格一致性 sref，boolean 类型。
      
    • cref: 参考图是否用于角色一致性 cref，boolean 类型。
      
    • sw: 参考图用于风格一致性 sref 时的权重，number 类型，取值 0 - 1000（默认 100）。
      
    • cw: 参考图用于角色一致性 cref 时的权重，number 类型，取值 0 - 100（默认 100）。
      
    
    
  • color: 彩通 TPG 色号，string 类型，选填，如 11-0105TPG。色号界说详见 https://www.qtccolor.com/secaiku/dir/6 ，TPG 色号共计 2625 种。
    
  
  
• 哀求参数示例
  { "prompt": "赛博朋克多数市", "model": "mj-v6", "params": { "aspect": "16:9", "stylize": 100, "quality": 1, "chaos": 0, "style": "raw", "seed": 123456, "no": [ "cat", "dog" ] }, "images": [{ "url": "https://yyy.com/aaa.jpg", "type": "image/jpg", "size": 1024123, "w": 1280, "h": 800, "cref": true, "cw": 0 }] }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  • prompt: 最终生效的画图提示词，string 类型，包罗画图描述、完整参数和参考图片等信息。
    
  • model: 最终生效的模子版本，同哀求字段界说。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片天生使命创建成功", "data": { "id": "6613e99751dbca13297821c4", "prompt": "Cyberpunk Metropolis --aspect 16:9 --stylize 100 --quality 1 --chaos 0 --cref https://yyy.com/aaa.jpg --cw 0 --style raw --v 6", "model": "mj-v6" } }
  

图片拆分

---

POST /midjourney/separate

• 阐明：从天生的四宫格图片中拆分放大出指定的一张。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片天生」API 创建并天生完毕。
    
  • index: 需拆分的图片索引，number 类型，必填，取值 1（左上 U1）、2（右上 U2）、3（左下 U3）、4（右下 U4）
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", "index": 2 }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片拆分放大使命创建成功", "data": { "id": "6545bfe3e2b4e547e8414565", } }
  

图片微调（四宫格）

---

POST /midjourney/variation

• 阐明：以四宫格图片中的一张图片为参考，微调变动后天生新的四宫格图片。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片天生」API 创建并天生完毕。
    
  • index: 微调变化需参考的图片索引，number 类型，取值 1（左上 V1）、2（右上 V2）、3（左下 V3）、4（右下 V4）。
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", "index": 1 }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片微调使命创建成功", "data": { "id": "64a01843d9dedd09fd77bc2d" } }
  

图片重绘

---

POST /midjourney/reroll

• 阐明：针对已天生的四宫格图片进行整体重绘（保存原提示词和参数不变），天生新的四宫格图片。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片天生」API 创建并天生完毕。
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片重绘使命创建成功", "data": { "id": "6496f970e2aedf9465538208", } }
  

图片高清

---

POST /midjourney/upscale

• 阐明：针对拆分后的单张图片进行高清放大。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片拆分」API 创建并天生完毕。
    
  • type: 图片放大类型，string 类型，取值 subtle（2 倍原图高清，保存原图细节，默认值，mj-v6 和 niji-6 适用）、creative（2 倍增强高清，添加新细节，mj-v6 和 niji-6 适用）、2x（2 倍原图高清，mj-v5.2 和 niji-v5 适用）、4x（4 倍原图高清，mj-v5.2 和 niji-v5 适用）
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", "type": "subtle" }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片放大使命创建成功", "data": { "id": "64a01843d9dedd09fd77bc2d", } }
  

图片微调（单图）

---

POST /midjourney/vary

• 阐明：针对拆分或高清放大后的单张图片进行微调变化。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片拆分」或「图片高清」API 创建并天生完毕。
    
  • type: 图片变化类型，string 类型，取值 subtle（稍微变化）、strong（强烈变化）
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", "type": "strong" }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片微调变化使命创建成功", "data": { "id": "64a01843d9dedd09fd77bc2d", } }
  

图片变焦

---

POST /midjourney/zoomout

• 阐明：针对拆分后的单张图片进行画面变焦（1.5 倍和 2 倍）。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片拆分」API 创建并天生完毕。
    
  • type: 画面变焦倍数，string 类型，取值 1.5x（1.5 倍）、2x（2倍）
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", "type": "2x" }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片变焦使命创建成功", "data": { "id": "64a01843d9dedd09fd77bc2d", } }
  

图片平移

---

POST /midjourney/pan

• 阐明：针对拆分后的单张图片进行画面平移扩展。
  
• 哀求参数（POST body）
  
  
  
  • id: 画图使命 ID，string 类型，必填，该使命由「图片拆分」API 创建并天生完毕。
    
  • type: 画面平移方向，string 类型，取值 left（向左）、right（向右）、up（向上）、down（向下）
    
  
  
• 哀求参数示例
  { "id": "6613e99751dbca13297821c4", "type": "left" }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片平移使命创建成功", "data": { "id": "64a01843d9dedd09fd77bc2d", } }
  

图片描述

---

POST /midjourney/describe

• 阐明：提供 1 张图片 (JPG/PNG/WebP)，模子天生 4 个可能的提示词。天生的提示词有启发性和暗示性，通常用于来探索新词汇和美学效果，不能用于精确重现已上传的图片。
  
• 哀求参数（POST body）
  
  
  
  • image: object 类型，必填，参数如下：
    
    
    
    • url: 图片完整 URL，string 类型，必填，需确保访问该 URL 能正常下载图片文件。
      
    • type: 图片 MIME 类型，string 类型，必填，取值 image/png，image/jpg，image/jpeg，image/webp。
      
    • size: 图片文件大小，number 类型，图片文件大小（bytes）。
      
    • w: 图片宽度，number 类型。
      
    • h: 图片高度，number 类型。
      
    
    
  
  
• 哀求参数示例
  { "image": { "url": "https://yyy.com/aaa.jpg", "type": "image/jpg", "size": 1024123, "w": 1280, "h": 800, } }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的图片描绘使命 ID，string 类型，可用于后续效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片描述使命创建成功", "data": { "id": "6613e99751dbca13297821c4", } }
  

图片融合

---

POST /midjourney/blend

• 阐明：提供 2 - 5 张图片 (JPG/PNG/WebP)，模子根据每张图片的概念和美学，合并天生 1 张新的四宫格图片。
  
• 哀求参数（POST body）
  
  
  
  • images: 参考图参数，array 类型，必填，可包含 2 - 5 张原图，每张原图界说为 object 类型。
    
    
    
    • url: 图片完整 URL，string 类型，必填，需确保访问该 URL 能正常下载图片文件。
      
    • type: 图片 MIME 类型，string 类型，必填，取值 image/png，image/jpg，image/jpeg，image/webp。
      
    • size: 图片文件大小，number 类型，图片文件大小（bytes）。
      
    • w: 图片宽度，number 类型。
      
    • h: 图片高度，number 类型。
      
    
    
  • dimension: 融合天生的图片比例，string 类型，取值 square（1:1 正方形宽高比，默认值），landscape（3:2 横向宽高比），portrait（2:3 纵向宽高比）。
    
  
  
• 哀求参数示例
  { "images": [ { "url": "https://yyy.com/aaa.jpg", "type": "image/jpg", "size": 1024123, "w": 1280, "h": 800 }, { "url": "https://yyy.com/aaa.jpg", "type": "image/jpg", "size": 1024123, "w": 1280, "h": 800 } ], "dimension": "square" }
  
• 返回数据（data）
  
  
  
  • id: 成功创建的画图使命 ID，string 类型，可用于后续各类图片变动和画图效果查询。
    
  
  
• 返回数据示例
  { "status": "Success", "message": "Midjourney 图片融合使命创建成功", "data": { "id": "6613e99751dbca13297821c4" } }
  

查询效果

---

GET /midjourney/result/{id}

• 阐明：查询画图使命的执行进度和效果，调用方可定时轮询（思量画图速率，建议周期不低于 5 秒）。
  
• 哀求参数（HTTP GET params）
  
  
  
  • id: 各类图片天生或变动 API 中成功创建的画图使命 ID。
    
  
  
• 返回数据（data）
  
  
  
  • id: 画图使命 ID，string 类型
    
  • status: 使命状态，string 类型，取值 submitted（排队中）、in_progress（执行中，具体进度拜见 progress）、failure（执行失败，具体缘故原由拜见 fail_reason）、success（执行成功）。
    
  • progress: 使命进度（百分比），number 类型，0 - 100。
    
  • fail_reason: 使命失败缘故原由，string 类型，使命执行失败后返回。
    
  • image_url: 最终天生的图片 URL，string 类型，使命执行成功后返回。
    
  • image_url_mirror: 最终天生的图片 URL（七牛镜像地址），string 类型，使命执行成功后返回。
    
  • image_description: 图片描绘使命最终天生的提示词，string 类型，使命执行成功后返回。
    
  • total_points: 使命消耗的元点，number 类型，使命执行成功后返回。
    
  • prompt: 原始提示词，string 类型。
    
  • revised_prompt: 最终生效的画图提示词，string 类型，包罗画图描述、画图参数、参考图和模子版本等信息。
    
  • model: 最终生效的模子版本，string 类型，详见「图片天生」API 描述。
    
  • command: 画图使命指令，string 类型。
    
  • params: 最终生效的画图参数，object 类型，详见「图片天生」API 描述。
    
  • images: 原始参考图列表，array 类型，详见「图片天生」API 描述。
    
  • submitted_at: 使命提交时间，number 类型，UNIX 时间戳（秒）。
    
  • started_at: 使命启动时间，number 类型，UNIX 时间戳（秒）。
    
  • finished_at: 使命竣事时间，number 类型，UNIX 时间戳（秒）。
    
  
  
• 返回数据示例
  [code][/code] { "status": "Success", "message": "Midjourney 画图使命查询成功", "data": { "id": "6613e99751dbca13297821c4", "status": "success", "progress": 100, "image_url": "https://aaa.bbb.ccc/generated_image.png", "image_url_mirror": "https://aaa.bbb.ccc.qiniu.com/generated_image.png", "total_points": 350, "prompt": "赛博朋克多数市", "revised_prompt": "Cyberpunk Metropolis --aspect 16:9 --stylize 100 --quality 1 --chaos 0 --cref https://yyy.com/aaa.jpg --cw 0 --style raw --v 6", "model": "mj-v6", "params": { "aspect": "16:9", "stylize": 100, "quality": 1, "chaos": 0, "style": "raw", "seed": 123456, "no": [ "cat", "dog" ] }, "images": [ { "url": "https://yyy.com/aaa.jpg", "type": "image/jpg", "size": 1024123, "w": 1280, "h": 800, "cref": true, "cw": 0 } ], "submitted_at": 1714051763, "started_at": 1714051770, "finished_at": 1714051864 } }
  

最新API文档更新访问：Midjourney API | MetaChat Knowledge Base

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。