图像生成 - MetaChat API

根据提示词、参数和参考图，生成或编辑图像。

curl --location --request POST 'https://api.mmchat.xyz/open/v1/flux/generate' \ --header 'X-App-ID: METACHAT_APP_ID' \ --header 'Authorization: Bearer METACHAT_API_KEY' \ --header 'Content-Type: application/json' \ --data-raw '{ "prompt": "给女孩带上墨镜", "model": "flux-kontext", "params": { "mode": "pro", "aspect": "9:16", "num": 1 }, "images": [ { "url": "https://example.com/ref.jpg", "type": "image/jpeg", "size": 2420934, "w": 3072, "h": 4096 } ] }'

{ "status": "Success", "message": "FLUX.1 图片生成任务创建成功", "data": { "id": "6613e99751dbca13297821c4", "prompt": "Cyberpunk Metropolis", "model": "flux-kontext", "mode": "pro" } }

请求参数

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

提示词

必需

绘图提示词，不超过 5000 字，支持中英文。

示例值:

给女孩带上墨镜

model

enum<string>

模型版本

可选

目前固定为 flux-kontext

枚举值:

flux-kontext

params

object

绘图参数

可选

mode

enum<string>

绘图模式

可选

FLUX.1 Kontext 模型的两种模式：pro、max，默认 pro。（当输入多张参考图时，固定使用 max 模式）

枚举值:

promax

默认值:

pro

num

integer

绘图数量

可选

>= 1<= 4

aspect

enum<string>

图像比例

可选

枚举值:

1:12:33:23:44:39:1616:99:2121:9

默认值:

1:1

images

array [object {5}]

参考图参数

可选

可包含 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

图片高度

可选

示例

返回响应

🟢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

最终生效的模型

必需

目前固定为 flux-kontext

mode

string

最终生效的模式

必需

取值 pro、max