图像生成
| 方法 | 路径 |
|---|---|
POST | /v1/images/generations |
请求体遵循 OpenAI Images 兼容格式，平台将其透传到支持图像生成的上游 Provider。核心入口是 POST /v1/images/generations。
bash
curl https://api.modelgo.ai/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 等，是否生效取决于实际路由到的上游模型能力。
响应形态
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 见接口清单。