图像生成 - MetaChat API

根据提示词、参数和参考图，生成 1 张四宫格图像。

curl --location --request POST 'https://api.mmchat.xyz/open/v1/midjourney/imagine' \ --header 'X-App-ID: METACHAT_APP_ID' \ --header 'Authorization: Bearer METACHAT_API_KEY' \ --header 'Content-Type: application/json' \ --data-raw '{ "prompt": "一个20岁的中国女子，她的上半身穿着一件轻薄休闲外套，她的下半身穿着一件牛仔裤，站在大街上，照片从正面拍摄，采用全身照。", "model": "mj-v7", "params": { "aspect": "9:16", "stylize": 100, "quality": 1, "chaos": 0, "style": "raw" }, "images": [ { "url": "https://example.com/ref.jpg", "type": "image/jpeg", "size": 2420934, "w": 3072, "h": 4096, "oref": true, "ow": 400 } ] }'

{ "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.1", "model": "mj-v61" } }

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

X-App-ID

string

必需

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

示例值:

METACHAT_APP_ID

Authorization

string

必需

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

示例值:

Bearer METACHAT_API_KEY

Body 参数application/json

prompt

string

提示词

必需

支持中英文。提示词末尾可携带自定义参数（例如 --style raw --ar 1:1 --v 7 等），自定义参数会覆盖 params 中对应参数，未提供自定义参数时，以 params 参数为准。

示例值:

赛博朋克风格的大都会夜景

model

enum<string>

模型版本

可选

默认 mj-v61

枚举值:

mj-v7mj-v61mj-niji-6

示例值:

mj-v7

params

object

绘图参数

可选

aspect

string

图像比例

可选

取值 1:1（默认），2:3，3:2，3:4，4:3，16:9，9:16 等。

默认值:

1:1

示例值:

1:1，2:3，3:2，3:4，4:3，16:9，9:16 等

stylize

integer

风格化程度

可选

取值 1 - 1000（默认 100）

exp

integer

实验性的图像美学参数

可选

仅限 mj-v7 模型版本

quality

enum<number>

画质

可选

取值 0.5（标清），1（高清，默认），2（超清），4（实验，仅限 mj-v7 模型）。

枚举值:

0.5124

默认值:

chaos

integer

混乱程度

可选

取值 0 - 100（默认 0）

style

enum<string>

绘图风格

可选

取值 raw

枚举值:

raw

seed

integer

随机种子

可选

取值 0 - 4294967295 间的整数。

array[string] | null

排除关键词列表

可选

支持中英文，单个关键词不要包含空格

integer

普通垫图权重

可选

当参考图用于 Image Prompt 时有效，取值 0 - 3（默认 1）。

images

array [object {12}]

参考图参数

可选

可包含 1 - 3 张参考图（JPG/PNG/WebP 格式）

>= 0 items<= 3 items

url

string

图片完整 URL

必需

需确保访问该 URL 能正常下载图片文件。

type

enum<string>

图片 MIME 类型

必需

取值 image/png，image/jpg，image/jpeg，image/webp。

枚举值:

image/pngimage/jpgimage/jpegimage/webp

size

integer

图片文件大小

可选

图片文件大小（bytes）

integer

图片宽度

可选

integer

图片高度

可选

image_prompt

boolean

参考图是否用于普通垫图（Image Prompt）

可选

cref

boolean

参考图是否用于角色一致性参考（Character Reference）

可选

仅限 mj-v61 / mj-v6 模型版本

oref

boolean

参考图是否用于全能一致性参考（Omni Reference）

可选

仅限 mj-v7 模型版本

sref

boolean

参考图是否用于风格一致性参考（Style Reference）

可选

integer

参考图用于风格一致性 sref 时的权重

可选

取值 0 - 1000（默认 100）

integer

参考图用于角色一致性 cref 时的权重

可选

取值 0 - 100（默认 100）

integer

参考图用于全能一致性 oref 时的权重

可选

取值 1 - 1000（默认 100）

示例

返回响应

🟢200成功

application/json

Body

status

enum<string>

API 调用结果

必需

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

枚举值:

SuccessFail

message

string

描述信息

必需

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

data

object

API 返回数据

可选

当结果 Fail 时 data 为空。

string

成功创建的绘图任务 ID

必需

可用于后续各类图片变换和绘图结果查询。

prompt

string

最终生效的绘图提示词

必需

包括绘图描述、完整参数和参考图片等信息。

model

string

最终生效的模型版本

必需

同请求参数中的 model 参数