接口鉴权

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

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

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

具体方法：

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

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

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

异常处理

FLUX 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": "FLUX.1 绘图描述中存在错误的参数，请修改后重新提交。",
    "data": null
}