文生图

推荐使用异步入口创建一个图片任务，再查询结果。调用前先确认完整 model 在当前 Key 的目录里，按下表选择型号专章，再填写对应参数。Seedream 的 resolution 是图片档位，不能与视频分辨率或其他图片模型字段混用。

各系列参数入口

异步生成

POST https://openpix.cc/v1/images/generations/async

请求使用 Bearer Key 和 application/json；正常接纳返回 HTTP 202，随后按图片任务查询。

curl --fail-with-body --max-time 60 \
  https://openpix.cc/v1/images/generations/async \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-image-2.5","prompt":"木桌上的白色茶杯，柔和自然光，产品摄影","size":"1024x1024","n":1}'

收到任务对象即保存 task_id，不要直接读取 data[0].url。后台生成失败可能发生在 HTTP 202 之后，必须继续查询终态。

规格与可选参数

gpt-image-2.5-flare、gpt-image-2.5-sunburst 与普通 gpt-image-2.5 是不同完整型号。使用高质量或高规格时确认当前分组权限与报价；不能把一个型号的 high/xhigh/max 直接套给其他型号。

background、output_format、output_compression、moderation、seed、mask 等字段不是本站对全部图片型号统一保证的能力。Gemini Images 适配主要处理 prompt、size、n 与参考图；需要原生配置时看Gemini 原生接口。

异步开关中的 background:true 为布尔值。背景样式的 background:"transparent" 是字符串，两者含义不同。推荐直接用 /async 避免歧义。

同步生成

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

curl --fail-with-body --max-time 600 \
  https://openpix.cc/v1/images/generations \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-image-2.5","prompt":"一只蓝色陶瓷茶壶，产品摄影","size":"1024x1024","n":1}'

同步适合能保持长连接的服务端。600 秒是客户端示例超时，不是生成时延保证；网络断线不等于服务端没有生成。业务通常优先选择异步，便于保存 ID 和恢复查询。

同步结果示意

{
  "created": 1793203200,
  "data": [
    {"url": "https://openpix.cc/generated/example.png"}
  ]
}

时间与链接为示意。先检查 HTTP 和 error，再检查 data 非空。结果为 b64_json 时 Base64 解码保存；URL 则下载原图。文件扩展名不会改变真实格式。

下载图片直链不要附带 API Key。使用临时文件，验证响应类型、文件头和真实图片可解码后再保存正式结果。批量任务对每张图片分别跟踪，避免把部分成功当作全部成功。

相关章节

参考图编辑见图生图，状态和保留期见图片任务，完整客户端见代码下载，质量档位与分组费用见分组与计费。