文生图

推荐：异步生成

POST https://api.manxiaobai.online/v1/images/generations/async

请求头为 Bearer Key 与 Content-Type: application/json。正常接纳返回 HTTP 202，随后按异步任务查询结果。

字段	类型	是否必填	使用说明
model	string	是	完整公开模型 ID，且当前 Key 有权限
prompt	string	是	图片描述，使用非空文本；长度上限由模型/渠道决定
size	string	建议显式填写	如 `1024x1024`；按模型规格选择
n	integer	建议固定 1	一次生成一张，避免多图的部分失败及计费差异
quality	string	可选	GPT 2.5 建议省略或使用 `auto/high`；其他模型按渠道能力
response_format	string	建议省略	异步目标为托管 URL，不保证按 `b64_json` 返回
stream	boolean	不使用	当前图片异步层不提供可靠的 SSE 终态解析

background、output_format、output_compression、moderation、seed 等不属于本站对全部图片模型统一保证的能力；不要仅因其他平台支持便直接套用。Gemini Images 适配主要使用 prompt、size、n 和参考图，不会原样转发任意生成参数；需要原生字段时见 Gemini 原生接口。

bash

curl --fail-with-body --max-time 60 \
  https://api.manxiaobai.online/v1/images/generations/async \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gemini-3.1-flash-image-preview-1k","prompt":"木桌上的白色茶杯，产品摄影","size":"1024x1024","n":1}'

同步生成

POST /v1/images/generations，不加异步开关。它会等待生成结果，正常响应通常包含 data[].url 或 data[].b64_json。

同步适合能保持长连接的服务端。网络、客户端或中间代理超时不代表生成未发生。普通业务优先使用异步，以便保存任务 ID 并查询结果。

AZ 目前仅建议验证过的同步方式，省略 response_format：

bash

curl --fail-with-body --max-time 600 \
  https://api.manxiaobai.online/v1/images/generations \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-image-2-az","prompt":"一只蓝色陶瓷茶壶","size":"1024x1024","n":1}'

600 是示例客户端超时，不是服务时延保证。AZ 按 token 计费，不能按首页普通 GPT 的固定起价估算。

同步结果示意

json

{
  "created": 1789550000,
  "data": [
    {"url": "https://api.manxiaobai.online/generated/example.png"}
  ]
}

时间和链接是结构示例。客户端应先检查 HTTP 状态与 error，再检查 data 非空。只有 data[].b64_json 时解码保存；不能假定 HTTP 200 必然包含可用图片。