接口鉴权

MetaChat Midjourney API 接口的服务端基础 URL 和 API 前缀如下：

主用: https://api.mmchat.xyz/open/v1
备用: https://api2.mmchat.xyz/open/v1

调用 Midjourney API 时，需使用 App ID 和 API Key 进行鉴权（App ID 和 API Key 获取方法请参考概述文档说明。

具体方法：

在 HTTP Header 中增加 X-App-ID 字段，填写 App ID。

在 HTTP Header 中增加标准的 Authorization Bearer 字段，填写 API Key。

Midjourney API 参数格式为 JSON，请在 HTTP Header 中标识相应的 Content-Type，并注意请求参数的填写和响应参数的解析。
以 curl 命令行工具调用为例：

异常处理

Midjourney 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
}

为防止滥用和攻击，MetaChat API 对调用方的访问频次按照如下配额进行限流：

Midjourney API：50 RPM（每分钟 50 次）。

当超出配额后，将返回 HTTP status code 429，调用方可据此进行主动流控，稍后再试。