# 图片生成

> 统一异步图片提交：字段、各模型限制与尺寸换算。

Base URL：`https://platform.sgt.site`

| 方法 | 路径 |
| --- | --- |
| POST | `/apimart/v1/images/generations` |

<a id="apimart-images-section-1"></a>

## 3.1 请求字段

| 字段 | 类型 | 适用范围和含义 |
| --- | --- | --- |
| `model` | string | 必填，已适配图片模型 |
| `prompt` | string | 必填非空；最长 32000 字节；各模型可能有更小的限制（如 Seedream 建议中文不超过 300 字） |
| `size` | string | 比例、支持的像素尺寸或 Seedream 分辨率档位；见下文 |
| `resolution` | string | 模型支持的输出分辨率档位 |
| `n` | integer | 默认 1；Gemini 与 Seedream 5 Pro 只能为 1 |
| `image_urls` | string[] | 可选参考图，HTTP(S) URL 或受支持图片 Data URI |
| `response_format` | string | `url/b64_json`，省略时按 url 语义处理；不改变异步响应结构 |
| `watermark` | boolean | 仅 Seedream，默认 false |
| `output_format` | string | 仅 Seedream，`jpeg/png` |
| `sequential_image_generation` | string | 仅 Seedream，`disabled/auto`；组图限制见 3.4 |
| `sequential_image_generation_options` | object | 仅 Seedream，只允许 `max_images` |

Gemini 不接受 `watermark/output_format/sequential_image_generation`；所有图片型号均不接受 `stream`、`callback_url`、`negative_prompt`、`layer_decomposition`、`background` 或任意未列出字段。不要把原生字段直接照搬到 APIMart。

图片 Data URI 的本地白名单为 `image/png`、`image/jpeg`、`image/webp`、`image/gif`、`image/avif`，格式为 `data:image/png;base64,...`。通过语法校验不代表目标模型支持全部格式；新接入建议优先使用 PNG/JPEG。`asset://...` 不是本入口支持的媒体引用。

<a id="apimart-images-section-2"></a>

## 3.2 各模型限制

| 模型 | resolution | 缺省 size / resolution | n 与参考图 |
| --- | --- | --- | --- |
| Seedream 5 Pro | `1K/1.5K/2K` | 自适应 / 1K | n=1，最多 10 张参考图 |
| Seedream 5 Lite | `2K/3K/4K` | 1:1 / 2K | n=1..15，参考图数+n≤15；组图见 3.4 |
| Seedream 4.0 | `1K/2K/4K` | 1:1 / 2K | 同上 |
| Seedream 4.5 | `2K/4K` | 1:1 / 2K | 同上 |
| 平台 Seedream 5 扩展型号 | `2K/3K/4K` | 1:1 / 2K | 同 Seedream 5 Lite |
| Gemini 3.1 Flash Image / 3 Pro Image | `1K/2K/4K` | 1:1 / 1K | n=1，最多 14 张参考图 |
| Gemini 3.1 Flash Lite Image | `1K` | 1:1 / 1K | n=1，最多 14 张参考图 |
| Gemini 2.5 Flash Image | 固定输出档；显式 resolution 只接受 1K | 1:1 / 固定画布 | n=1 |

Gemini 的 HTTP 参考图由平台下载后转为内嵌图片：单张不超过 20 MiB，合计不超过 32 MiB，必须是位图（不接受 SVG）。图片提交整体受 4 MiB 请求体限制，内嵌 Base64 尤其需要控制体积。图片地址需要登录或禁止服务端访问时会下载失败。

Seedream 参考图还需满足官方要求：格式 jpeg、png、webp、bmp、tiff、gif、heic、heif，单张不超过 30 MB，宽、高均大于 14 px，总像素不超过 6000×6000，宽高比 [1/16, 16]。详见原生协议 Seedream 章节“官方接口与输入限制”。

<a id="apimart-images-section-3"></a>

## 3.3 size 与 resolution

Seedream 比例支持：

```text
auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9
```

Gemini 比例支持：

```text
auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
```

两者均接受 `size="宽x高"`；兼容 `X`、`×` 和两侧空格。已经支持的 `2x1` 等小数字写法仍按比例解释。像素的宽高须为正整数且不超过 65536，比例在 1:16–16:1 内。

- Seedream：未显式指定 resolution 时，处于模型像素范围内的尺寸原样使用；低于最低像素面积时，保留比例放大到默认档位；超过最高像素面积返回 400。各模型像素范围：5 Pro 为 921600–4624220，4.0 为 921600–16777216，5 Lite 与 4.5 为 3686400–16777216。
- Gemini：像素转换为最接近的受支持比例，再按面积选 1K/2K/4K 档位；仅支持 1K 的型号固定为原生画布。因此不保证精确输出请求的像素尺寸。
- 显式 resolution 决定输出档位，像素只提供比例；不支持的档位返回 400。
- Seedream 还接受 `size="2K"` 这类档位写法；如同时指定 resolution，二者必须一致。Gemini 不接受把 `2K` 当 size，应写在 resolution。
- `auto` 是本接口图片的自动比例值，不使用视频的 `adaptive`。

| 输入示例 | 当前转换结果 |
| --- | --- |
| Seedream 5 Lite，size=1344x1008 | size=2304x1728 |
| Seedream 5 Pro，size=2048x1536 | 原样保留 |
| Seedream 5 Lite，size=1344x1008，resolution=3K | size=3456x2592 |
| Gemini 3.1 Flash/3 Pro，size=2048x1536 | aspectRatio=4:3，imageSize=2K |
| Gemini Lite，size=2048x1536 | aspectRatio=4:3，imageSize=1K |

<a id="apimart-images-section-4"></a>

## 3.4 组图当前边界

兼容层接受以下组合：

- `n>1` 自动准备顺序组图请求；如果显式 `sequential_image_generation=disabled` 则拒绝。
- 显式 `sequential_image_generation=auto` 时必须同时提供 n。
- 提供 options 时，必须有 `max_images` 且等于 n；不接受其他 options 字段。
- Seedream 5 Pro 只接受单图，不接受 auto 组图。

**注意：**组图（n>1）目前不保证返回多张图片，可能只返回 1 张。需要多张图片时，建议分多次提交 n=1 的任务。实际返回少于请求数量时，以结果中的图片列表为准，费用按实际产出结算。

<a id="apimart-images-section-5"></a>

## 3.5 图片请求示例

Seedream 文生图：

```http
POST /apimart/v1/images/generations HTTP/1.1
Authorization: Bearer YOUR_VIRTUAL_KEY
Content-Type: application/json
```

```json
{
  "model": "seedream-5-0-lite",
  "prompt": "一只白色陶瓷杯的电商主图，浅灰背景，柔和自然光",
  "size": "1:1",
  "resolution": "2K",
  "n": 1,
  "watermark": false,
  "response_format": "url"
}
```

Seedream 参考图：

```json
{
  "model": "seedream-5-0-pro",
  "prompt": "保留参考图中的产品，将背景改成木质桌面",
  "image_urls": ["https://media.example.com/source.png"],
  "size": "4:3",
  "resolution": "2K",
  "n": 1,
  "output_format": "png",
  "watermark": false
}
```

Gemini / Nano Banana 2：

```json
{
  "model": "gemini-3.1-flash-image-preview",
  "prompt": "参考图片中的运动鞋，生成白色背景产品展示图",
  "image_urls": ["https://media.example.com/shoe.png"],
  "size": "4:3",
  "resolution": "1K",
  "n": 1
}
```

图片提交返回任务 ID，后续按[第 5 节：任务查询与结算](apimart-tasks.md)查询；即使 response_format 为 b64_json，也不会在提交响应里直接返回图片。