图像描述 - MetaChat API

提供 1 张图像 (JPG/PNG/WebP)，模型生成 4 个可能的提示词。生成的提示词有启发性和暗示性，通常用于来探索新词汇和美学效果，不能用于精确重现已上传的图片。

curl --location --request POST 'https://api.mmchat.xyz/open/v1/midjourney/describe' \ --header 'Authorization: Bearer METACHAT_API_KEY' \ --header 'X-App-ID: METACHAT_APP_ID' \ --header 'Content-Type: application/json' \ --data-raw '{ "image": { "url": "https://yyy.com/aaa.jpg", "type": "image/jpg", "size": 1024123, "w": 1280, "h": 800 } }'

请求参数

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

Body 参数application/json

images

object

参考图参数

可选

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

url

string

图像完整 URL

必需

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

type

string

图像 MIME 类型

必需

取值 image/png，image/jpg，image/jpeg，image/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

最终生效的模型版本

必需

同请求参数中的 model 参数