# MJ / Seedream 图片生成

https://video-doc.1route.dev/zh/docs/images



本页介绍 **Video 站内的图片接口**。使用 `https://video.1route.dev`，在[Video 控制台](https://video.1route.dev/keys/)创建 **Midjourney 分组**的 Key；Seedream 5.0 Pro 也使用该分组。先调用 `GET /v1/models` 确认自己的 Key 权限。

[图片 OpenAPI](/images-openapi.json) · [图片模型与价格 JSON](/image-models.json) · [模型广场](https://video.1route.dev/pricing/)

## 模型与价格 [#模型与价格]

价格核对日期：**2026-10-08**。金额使用站内余额单位，与充值余额一致；后续调整以控制台和请求提交时的价格为准。

| API 模型名称           | 单价    | 计费单位   |
| ------------------ | ----- | ------ |
| `Midjourney v6`    | 0.12  | 每次生成   |
| `Midjourney v6.1`  | 0.12  | 每次生成   |
| `Midjourney v7`    | 0.12  | 每次生成   |
| `Midjourney v8.1`  | 0.12  | 每次生成   |
| `Midjourney v8.2`  | 0.12  | 每次生成   |
| `Seedream 5.0 Pro` | 0.095 | 每张成功图片 |

MJ 按 `n` 次生成计费。`n=1` 收费 0.12，`n=3` 收费 0.36；同一次生成中的四格候选图不再重复计费。Seedream 按成功图片张数结算。明确的生成失败按本站退款流程处理；结果未知时先核查原请求，避免重复扣费。

本站实测：**MJ v8.2 文生图与 Seedream 5.0 Pro 参考图编辑成功**。其余 MJ 版本已配置到渠道和模型目录，尚未逐个付费生成验证。模型专属参数也未逐项实测。

## 接口与返回方式 [#接口与返回方式]

| 操作              | 方法与路径                         |
| --------------- | ----------------------------- |
| 查看自己的可用模型       | `GET /v1/models`              |
| 文生图或 JSON 参考图生成 | `POST /v1/images/generations` |
| 参考图编辑或文件上传      | `POST /v1/images/edits`       |
| 保存图片、检查下载头      | `GET` / `HEAD` 返回的本站图片链接      |

生成与编辑请求携带 `Authorization: Bearer YOUR_VIDEO_API_KEY`。接口同步返回完整 JSON，耗时可能数分钟，建议客户端超时至少设为 600 秒。没有公开图片任务轮询或流式接口，不要按视频任务格式提交或轮询图片。

* `response_format="url"`：返回 `video.1route.dev/v1/images/content/...` 的本站链接，**7 天内有效**。链接持有人可以读取该图片；不要公开分享私密图片的链接，收到结果后及时保存。
* `response_format="b64_json"`：只返回图片 Base64，不附加图片 URL；解码后保存为 PNG。
* 图片由本站下载并去除 EXIF 等来源元数据，下载头使用通用文件名。下载失败返回本站错误，不回退到外部图片链接。

图片的 7 天规则与视频的临时缓存时间不同，请分别处理。

## MJ 文生图 [#mj-文生图]

```bash
curl --fail-with-body --max-time 650 \
  https://video.1route.dev/v1/images/generations \
  -H "Authorization: Bearer $VIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
    "model": "Midjourney v8.2",
    "prompt": "A red apple on a white ceramic plate, pale blue background",
    "n": 1,
    "aspect_ratio": "1:1",
    "hd": false,
    "response_format": "url"
  }'
```

响应示意，链接以实际返回值为准：

```json
{
  "created": 1791439200,
  "data": [{"url": "https://video.1route.dev/v1/images/content/EXPIRY-OPAQUE_ID.png"}]
}
```

## Seedream 参考图编辑 [#seedream-参考图编辑]

JSON 支持 `images` 数组，也接受 `image` 或 `image_urls`。参考素材可使用公网图片 URL、图片 data URI 或 Base64；每个模型的参考数量上限见下表。

```bash
curl --fail-with-body --max-time 650 \
  https://video.1route.dev/v1/images/edits \
  -H "Authorization: Bearer $VIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
    "model": "Seedream 5.0 Pro",
    "prompt": "Keep the subject and replace the background with a garden",
    "images": ["https://example.com/reference.png"],
    "size": "1:1",
    "resolution": "1k",
    "n": 1,
    "response_format": "b64_json"
  }'
```

本地图片可通过 multipart 上传，不要手写 Content-Type 边界：

```bash
curl --fail-with-body --max-time 650 \
  https://video.1route.dev/v1/images/edits \
  -H "Authorization: Bearer $VIDEO_API_KEY" \
  -F 'model=Seedream 5.0 Pro' \
  -F 'prompt=Keep the subject and replace the background with a garden' \
  -F 'n=1' -F 'resolution=1k' -F 'size=1:1' \
  -F 'response_format=url' -F 'image=@reference.png'
```

多张上传使用重复的 `image[]` 文件字段，每张文件不超过 **10 MiB**。MJ 的编辑入口用于多图参考，不支持蒙版局部编辑；本站目前不提供 MJ 放大、变体或独立任务查询接口。

## 参数范围 [#参数范围]

| 参数                | Midjourney                                                     | Seedream 5.0 Pro                                                     |
| ----------------- | -------------------------------------------------------------- | -------------------------------------------------------------------- |
| `prompt`          | 非空，最多 1024 个 Unicode 字符                                        | 非空，最多 5000 个 Unicode 字符                                              |
| `n`               | 整数 1–50，默认 1                                                   | 整数 1–50，默认 1                                                         |
| `count`           | `n` 的别名；同时给出时必须相同                                              | 同左                                                                   |
| `images`          | 最多 4 张参考图                                                      | 最多 10 张参考图                                                           |
| `aspect_ratio`    | `1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`4:5`、`5:4`、`21:9` | 使用 `size` 指定比例                                                       |
| `size`            | 比例或匹配比例的 `WIDTHxHEIGHT`，不保证任意固定像素                              | `1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`21:9`、`auto`，或匹配比例的像素尺寸 |
| `resolution`      | 省略；8.1/8.2 可使用 `hd`                                            | `1k` / `2k`                                                          |
| `response_format` | `url` / `b64_json`，默认 `url`                                    | 同左                                                                   |
| `stream`          | 省略或 `false`                                                    | 同左                                                                   |

MJ 模型名固定版本，请勿在提示词中使用 `--v`、`--version` 或 `--niji` 覆盖。未上架 Niji。

MJ 还接受 `quality`、`style`、`stylize`、`chaos`、`weird`、`seed`、`tile`、`negative_prompt`、`sref`、`sw`、`iw`。`cref/cw` 适用于 6/6.1/7，`draft` 适用于 7/8.1/8.2，`hd` 适用于 8.1/8.2，`stop` 适用于 6/6.1。参数可以放顶层或 `params` 对象，同名顶层值优先，`0` 和 `false` 会保留。批次数量 `n/count` 必须放顶层。

## 超时与错误 [#超时与错误]

| 状态                | 处理                       |
| ----------------- | ------------------------ |
| 400               | 检查模型、数量、参考图与专属参数；先修正本地请求 |
| 401 / 403         | 检查本站 Key、分组和模型白名单        |
| 413               | 减少参考文件大小或数量              |
| 429 / 503         | 服务繁忙或资源不足；结果未知时先核查原请求    |
| 502 / 504 / 客户端超时 | 保存本站请求编号并联系支持，不自动重复生图    |

**超时不代表没有生成。生成成功但交付失败也不能靠重新生图找回原结果。** 保留响应头中的 `X-Oneapi-Request-Id`，交由管理员核查原请求和扣费记录；本站不会把供方地址、Key 或原始错误内容交给调用方。

其他图片模型的接入方式见[独立图片文档站](https://doc.1route.dev/zh/docs/)。本页所有调用使用 Video 站地址与 Video 站 Key。