图像生成

方法	路径
`POST`	`/v1/images/generations`

请求体遵循 OpenAI Images 兼容格式，平台将其透传到支持图像生成的上游 Provider。核心入口是 POST /v1/images/generations。

bash

curl https://api.modelgo.com/v1/images/generations \
  -H "Authorization: Bearer $MODELGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<model>","prompt":"a cat in neon city"}'

常见可选字段包括 size、quality、n 等，是否生效取决于实际路由到的上游模型能力。参数取值随请求透传到实际路由到的供应商；不受支持时返回 400，报错信息写明原因。各模型的交付形态见下文「响应形态」。

响应形态

data[] 里是 url 还是 b64_json，以各模型官方形态为准：网关不在两者之间转换，也不代为托管图片。response_format 随请求透传给支持它的模型；不接受它的模型，处理方式见下表。

模型	缺省形态	`response_format`
gpt-image 系列（`gpt-image-2` / `gpt-image-2.5-*`）	`b64_json`	上游不接受；网关转发前剥离，不报错，始终返回 `b64_json`
Qwen Image（`qwen-image-3.0` / `qwen-image-3.0-pro`）	`url`（链接 24 小时有效）	传 `b64_json` 不报错但被忽略，仍返回 `url`
Seedream（`doubao-seedream-*`）	`url`（链接 24 小时有效）	`url` / `b64_json` 均支持

切换模型时不要写死 data[0].url 或 data[0].b64_json，按实际出现的字段取图（示例见图像编辑）。各模型详情见 GPT Image、Qwen Image、Seedream。

尺寸限制示例（Seedream）

doubao-seedream-5.0-lite 等模型对 size 有下限要求，过小的尺寸会被上游拒绝（HTTP 400、error_class=provider_invalid）；例如 1024x1024 可能失败，改用 2048x2048 可以正常返回。具体下限以官方文档为准；完整 curl 见接口清单。

doubao-seedream-4.0 同样支持本入口（另有方舟原生入口，见 Seedream 图像生成）：

n 必须省略或为 1：方舟 Images API 没有 n，n ≥ 2 返回 HTTP 400；一次出多张用 sequential_image_generation: "auto" + sequential_image_generation_options.max_images。
按张计费：组图一次生成 N 张即按 N × 单价结算。
图生图用 JSON 的 image 字段；multipart 的 /v1/images/edits 未对该模型开放，会返回 400 model_protocol_not_offered。
上游供应商只接受 JSON 请求体，multipart 形式不可用。