GPT 生图 API

模融GPT 生图 API 参考。

GPT 生图 API

GPT 图片接口遵循 OpenAI Images 兼容路径，可用于文生图和图片编辑。具体模型、参数组合和响应类型依当前 Key 与模型能力变化。

1. 接口总览

方法	路径	Content-Type	说明
`GET`	`/v1/models`	-	查询当前 Key 可用模型
`POST`	`/v1/images/generations`	`application/json`	文生图
`POST`	`/v1/images/edits`	`multipart/form-data`	图片编辑 / 图生图

Base URL：https://mrxapi.com/v1。

2. 鉴权和模型查询

curl "https://mrxapi.com/v1/models" \
  -H "Authorization: Bearer $MRXAPI_KEY"

从 data[].id 中选择可用图片模型。不要直接使用别处的固定模型名称。

3. 文生图

curl --request POST "https://mrxapi.com/v1/images/generations" \
  -H "Authorization: Bearer $MRXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "一只陶瓷杯，居中放在浅灰摄影棚背景中，柔和侧光，无文字",
    "n": 1,
    "size": "1024x1024"
  }'

4. 文生图参数

字段	必填	说明
`model`	是	模型列表中当前可用的图片模型
`prompt`	是	画面描述
`n`	否	请求数量；从 `1` 开始测试
`size`	否	请求尺寸，实际结果依模型能力为准
`quality`	否	质量档位，只有模型支持时使用
`output_format`	否	输出格式，只有模型支持时使用
`response_format`	否	响应兼容选项，客户端仍须检查实际返回

5. 图片编辑 / 图生图

编辑接口使用 multipart：

curl --request POST "https://mrxapi.com/v1/images/edits" \
  -H "Authorization: Bearer $MRXAPI_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=保留主体和构图，把杯子改为绿色，无文字" \
  -F "image=@./input.png"

如果所选模型支持遮罩，可追加 mask=@./mask.png。图片格式、尺寸和可选字段由模型能力决定。

6. 响应格式

成功结果位于 data 数组。图片可能通过 b64_json 或 url 返回：

{"data":[{"b64_json":"BASE64_IMAGE"}]}

服务端需要把 Base64 解码保存；URL 可能有有效期，应及时下载到自己的存储。不要只根据 HTTP 200 判断生成成功。

7. 常见错误

状态	处理
`400`	检查模型、JSON、图片格式和字段支持情况
`401`	检查 Bearer Key
`403`	检查当前分组是否具备图片能力
`404`	使用 `/v1/images/generations` 或 `/v1/images/edits`
`429`	减少并发，按退避策略重试
`5xx`	保存 request id 后有限重试

需要批量异步任务时，使用Gemini 批量生图 API，不要假设所有 GPT 图片模型都支持该扩展接口。