> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Midjourney V8.2 提示词参数手册

> Midjourney V8.2 模型在提示词中可使用的全部参数，包括取值范围、默认值、依赖关系、冲突关系、输入图片规则、长度限制与任务流程

## 参数总览

| 参数 | 写法 | 类型 | 取值范围 | 默认值 | 说明 |
| - | - | - | - | - | - |
| 宽高比 | `--ar W:H` | 整数比 | 任意正整数比，不支持小数 | 1:1 | 图像宽高比 |
| 混沌 | `--c N` | int | 0 - 100 | 0 | 生成结果的多样性 |
| 种子 | `--seed N` | int | 0 - 4294967295 | 随机 | 固定种子可复现结果 |
| 风格化 | `--s N` | int | 0 - 1000 | 100 | 艺术风格强度 |
| 实验参数 | `--exp N` | int | 0 - 100 | 0 | 美学效果，可与风格化叠加 |
| 质量（精细度） | `--quality N` / `--q N` | int | 1 - 4 | 1 | 图像细节程度；4 为高质量模式。不加价。V8.1 仅接受 1 / 4 |
| 原始模式 | `--raw` | 开关 | — | 关闭 | 禁用默认美化 |
| 反向提示词 | `--no 元素1, 元素2` | 文本 | — | — | 图中不希望出现的元素 |
| 图像权重 | `--iw N` | float | 0 - 3 | 1 | 垫图影响力 |
| 风格参考 | `--sref [URL]` | URL | — | — | 匹配视觉风格 |
| 风格权重 | `--sw N` | int | 0 - 1000 | 100 | 风格参考强度 |
| 个性化 | `--p [code]` | 代码 | — | — | 上游渠道创建的 moodboard id，原样透传 |
| 平铺 | `--tile` | 开关 | — | 关 | 生成无缝重复图案 |
| 怪异 | `--weird N` / `--w N` | int | 0 - 3000 | 0 | 非常规、实验性的美学效果 |

<Note>
  以下两项设置**不**写在 prompt 里，而是通过 API 参数控制（写在 prompt 中无效，会被剥离）：

  * **速度**（`draft` / `fast`）→ `model_params.speed`
  * **输出质量**（`standard` / `hd`）→ 顶层 `quality` 参数

  `--v` / `--version` 固定为 V8.2，不支持 `--niji`。详见下文[速度模式](#速度模式)与[输出质量](#输出质量)。
</Note>

***

## 基础参数

### 宽高比 `--ar`

设置图像的宽高比，仅支持整数比，小数会被拒绝（请写 `139:100`，不要写 `1.39:1`）。极端比例属实验性，效果可能不稳定。

```
一只猫 --ar 16:9
```

常见值：`1:1`、`4:3`、`3:2`、`16:9`、`9:16`、`2:3`。像素尺寸见[输出质量](#输出质量)。

### 混沌 `--chaos` / `--c`

控制生成结果的多样性。值越高，4 张图之间差异越大。

```
一只猫 --c 50
```

| 范围 | 效果 |
| - | - |
| 0 | 4 张图高度一致（默认） |
| 1-30 | 细微差异 |
| 30-70 | 适度多样 |
| 70-100 | 显著差异，适合创意探索 |

### 风格化 `--stylize` / `--s`

调节写实与艺术之间的平衡。

```
一只猫 --s 500
```

| 范围 | 效果 |
| - | - |
| 0-250 | 写实风格，忠实于提示词 |
| 250-750 | 平衡 |
| 750-1000 | 强烈艺术性，大胆色彩构图 |

### 实验参数 `--exp`

与 `--stylize` 类似但可叠加，生成更详细、动态、创意的图像。

```
一只猫 --exp 25
```

* 推荐值：5、10、25、50、100
* 5-50 效果变化明显，50-100 变化较小
* 超过 25–50 时可能覆盖 `--stylize` 与 `--p` 的效果；组合使用时请调低取值

### 质量 `--quality` / `--q`

设置图像细节程度。取值 1 - 4，默认 1；`4` 为高质量模式。该参数会原样透传给上游，**不改变价格**。

```
一只猫 --q 3
```

* V8.2 接受 `1` / `2` / `3` / `4`；V8.1 仅接受 `1` / `4`。超出范围的值会被拒绝：任务失败，错误信息会点名 `--quality` 及其允许的取值，预扣积分退还
* 取值越高渲染越久
* 仅生图接口可用；派生任务（变化、重塑、编辑等）继承源图

### 原始模式 `--raw`

禁用默认美化，更严格地遵循提示词细节。适用于追求真实感或精确控制的场景。

```
产品照片 --raw
```

### 反向提示词 `--no`

列出不希望出现在图中的元素，多个元素用逗号分隔，等价于为这些元素设置 -0.5 权重。在描述里写"没有水果"或"不要水果"无效——Midjourney 会把这些词当作内容处理——请改用该参数。

```
静物水粉画 --no fruit, flowers
```

### 种子 `--seed`

固定初始随机状态，用于对比测试。

```
一只猫 --seed 23453422
```

* 范围：0 - 4294967295
* 种子仅固定初始状态，不保证完全一致；提示词、参数或模型版本的任何变化都会改变结果
* 测试时使用固定种子，正式生成时使用随机种子以获得多样性

***

## 图像引用参数

### 图像提示（垫图）

在提示词**开头**放置图片 URL，用图片影响生成内容。

```
https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg 文本描述 --iw 1.5
```

**有效组合规则：**

| 组合方式 | 是否有效 |
| - | - |
| 1 张图 + 无文字 | 无效（会报错） |
| 1 张图 + 文字描述 | 有效 |
| 2+ 张图 + 无文字 | 有效 |
| 2+ 张图 + 文字描述 | 有效 |

* 最多 20 张垫图
* 支持格式：`.png`、`.gif`、`.webp`、`.jpg`、`.jpeg`；单张 ≤20 MB、边长 ≤16k 像素
* 纯图无文字的提示词与 `--stylize` / `--weird` 不兼容
* `draft` 速度下同样可用（已在本平台验证）；只有 `--tile` 不能与 `draft` 同用
* URL 必须能在几秒内公开访问，详见[输入图片要求](#输入图片要求)

### 图像权重 `--iw`

控制垫图对结果的影响力。范围 0 - 3，默认 1，值越高越接近参考图。

```
https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg 水彩风景 --iw 2.0
```

### 风格参考 `--sref`

匹配参考图的视觉风格（颜色、纹理、光照），不复制内容。**必须配合文本提示词使用**。

```
一只猫 --sref https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg
```

* 支持多张：`--sref URL1 URL2`；可用 `--sref URL1::2 URL2::1` 指定相对权重（悠船文档支持，本平台未实测）
* 支持随机风格：`--sref random`（生成后返回数字代码，可重用）
* 最多 20 个 sref
* 文本提示词只描述内容，不写指令（写"一只猫"，不要写"让它看起来像参考图"）

### 风格权重 `--sw`

控制风格参考的影响程度。范围 0 - 1000，默认 100。

```
一只猫 --sref https://cdn.evolink.ai/model-cards/midjourney-v8-2/midjourney-v8-2-og-v1.jpg --sw 500
```

### 个性化 `--p`

`--p` 会原样透传给上游；它接受的是上游渠道（悠船）在本平台机构号下创建的 moodboard id，本平台暂未开放 moodboard 的创建 / 列表接口，midjourney.com 的个人化 profile 码不适用。风格一致请用 `--sref` / `--sw` 与 `--seed`。`--p` 不能与 `--weird` 同用。

```
一只猫 --p abc123
```

***

## 速度模式

速度模式通过 API 的 `model_params.speed` 字段控制（请勿在提示词中写 `--draft` / `--fast`）。

各路由的取值：生图接受 `draft` / `fast`；重塑、画布编辑、转绘、上传重绘只接受 `fast`；变体与去背景没有 speed 字段（变体传 `speed: fast` 会被接受并忽略，其它值返回 `400`）。

| 模式 | 说明 | 费用 |
| - | - | - |
| `draft` | 单次运行返回 24 张轻量级 512 px 草图。仅限生图接口。 | 与 fast 同倍率 |
| `fast` | 标准模式（默认），每次生成 4 张图 | 标准 |

<Note>
  与 V7 不同，V8.2 的 `draft` 模式**不**减半收费——它与 `fast` 使用相同倍率。草图模式单次运行返回 24 张小图，挑出喜欢的再以完整质量重跑。草图模式不能与 `hd` 质量或 `--tile` 同用（`--oref` 在 V8.2 上完全不支持）。

  \*\*V8.2 不提供 Turbo。\*\*上游通道文档标注 V8 不支持极速模式，所有 V8.2 端点的 `speed: "turbo"` 都返回 `400`（与 V8.1 相同）。
</Note>

***

## 输出质量

输出分辨率通过顶层 `quality` 参数控制，**而非**提示词参数。请勿在提示词中写 `--hd`。

| 值 | 分辨率 | 费用 |
| - | - | - |
| `standard` | 标准分辨率，1:1 时长边约 1024 px（默认） | 1 倍 |
| `hd` | 原生 2K 输出，1:1 时约 2048 x 2048 | 1.5 倍 |

* 质量倍率与速度倍率是**相乘**关系
* `hd` 与 `draft` 速度**互斥**
* V8.2 没有独立的高清（放大）接口；上游对 V8 的"高清"就是用 `hd` 重新生成一次，需要 2K 输出时请直接使用 `quality: "hd"`

***

## 提示词长度限制

| 接口 | 限制 | 说明 |
| - | - | - |
| `mj-v8.2`（生图） | 上游限制**文本描述 1024 字符**；API 整体最多接受 2048 字符 | 上游只统计去掉图片 URL 和 `--参数` 后的描述部分，多出的空间留给 URL 和参数 |
| `mj-v8.2-remix` / `-edit` / `-retexture` / `-upload-paint` | 8100 字符 | 提示词作为编辑指令发送，不适用 1024 规则 |
| `mj-v8.2-variation` / `-remove-bg` | — | `prompt` 会被忽略 |

描述过长会被拒绝：任务失败并返回参数错误（`invalid_parameters`），预扣积分退还。

***

## 依赖关系

以下参数必须搭配其他参数才能生效：

| 参数 | 前置依赖 |
| - | - |
| `--sw` | 需要 `--sref` |
| `--iw` | 需要图像提示（垫图） |
| `--sref` | 需要文本提示词 |
| 单张垫图 | 需要文本提示词 |

***

## 冲突关系

| 参数 A | 参数 B | 说明 |
| - | - | - |
| `draft` 速度 | `hd` 质量 | 草图模式不能与 HD 组合 |
| `draft` 速度 | `--tile` | 不能同用 |
| `--weird` | `--p` | 不能同用 |
| 纯图像提示 | `--stylize` / `--weird` | 无文字时不兼容 |
| `--exp` > 25 | `--stylize` / `--p` | 高 `--exp` 可能压制它们；组合使用时请调低 `--exp` |

***

## V8.2 不支持的参数

V8.2 只剥离会破坏版本锁定或计费的参数，**其余参数一律原样透传给上游**。若上游不支持某个参数，任务会失败并返回参数错误（`invalid_parameters`），预扣积分全额退还——不会再静默丢弃。

| 参数 | 处理方式 |
| - | - |
| `--v` / `--version` / `--niji` | 剥离——版本固定为 V8.2 |
| `--fast` / `--turbo` / `--draft` / `--relax` | 剥离——请使用 `model_params.speed`（`draft` / `fast`；V8.2 不提供 turbo） |
| `--hd` | 剥离——请使用顶层 `quality` 参数 |
| `--bs` / `--batchsize` | 剥离——批量张数不可配置 |
| `--edit` | 为上游指令编辑接口保留，本平台暂未开放；当前所有端点写它都会被上游拒绝 |
| `--oref` / `--ow` | 上游拒绝（V8.2 不支持） |
| `--cref` / `--cw` | 上游拒绝（V8.2 不支持） |
| `--stop` | 上游拒绝 |
| 多提示词 `::` | 上游拒绝 |
| `--sv` | 仅接受 `--sv 6`，且须与 `--sref` 搭配 |
| `--repeat` / `--r`、`{}` 排列组合、`--stealth` / `--public` | API 不支持 |

<Note>
  上游通道（悠船）已为 V8.1 / V8.2 开放**指令编辑**接口（Midjourney Edit Model：`--edit`，最多 4 张参考图，可选透明遮罩局部重绘）。本平台尚未接入，正在排期中。`mj-v8.2-edit` 与 `mj-v8.2-upload-paint` 是画布编辑（`canvas` + `img_pos` + 可选 `mask`），`mj-v8.2-retexture` 是转绘工具。在当前任何接口的提示词里写 `--edit` 都会被上游拒绝。
</Note>

***

## 输入图片要求

以下规则适用于垫图、`--sref` URL，以及 retexture / upload-paint / remove-bg 的 `image_urls` 字段。

* **仅接受公开的 HTTP(S) URL。** 不接受 Base64 和 data URL。URL 本身不超过 1024 字符。
* **上游在创建任务时同步拉取图片，约 10 秒（本平台实测）后放弃。** 若无法在时限内下载文件，请求以 `400` 失败，不会创建任务。实际使用中，中国大陆以外的图床（imgur、ibb、raw\.githubusercontent、pinimg、picsum 等）几乎每次都会失败。请把图片放在快速 CDN 上，或先通过[文件上传 API](/docs/cn/api-manual/file-series/upload-url)上传并使用返回的 URL。
* 支持格式：`.png`、`.gif`、`.webp`、`.jpg`、`.jpeg`（`mj-v8.2-remove-bg` 仅接受 `.png` / `.jpg` / `.jpeg`）。单张 ≤20 MB、边长 ≤16k 像素；即使图床可达，过大的文件也可能超出拉取时限。
* `mj-v8.2-remove-bg` 不接受本平台 Midjourney 任务返回的带签名结果链接（URL 中含 `Expires` / `Signature`）。请重新托管图片或使用无签名 URL。retexture 与 upload-paint 接受这类链接。
* 垫图与 `--sref` 在 `draft` 速度下同样可用（已在本平台验证）；只有 `--tile` 与 `draft` 同用会被上游拒绝。

***

## 提示词格式规范

### 基本结构

```
[图片URL] 文本描述 --参数1 值1 --参数2 值2
```

### 书写规则

* 参数放在文本提示**末尾**
* `--` 前必须有**空格**
* 参数中不使用标点符号
* 参数后面不能再写文本
* 要在图中渲染文字，请用双引号包住：`a neon sign that says "OPEN" --ar 3:2`

### 示例

<CodeGroup>
  ```text 正确 theme={null}
  a yellow Persian cat --ar 1:2 --s 500
  ```

  ```text 错误 theme={null}
  a yellow Persian cat--ar 2:3          ← --前缺空格
  a yellow Persian cat - - ar 2:3       ← --间有空格
  a yellow Persian cat --ar 2:3, --s 50 ← 参数中有标点
  a yellow Persian cat --ar 2:3 more description ← 参数后有文本
  ```
</CodeGroup>

***

## 任务流程

V8.2 的七个模型均为异步任务，按次计费。

1. **提交** —— `POST /v1/images/generations` 立即返回任务 `id`、`status: processing` 和 `usage.credits_reserved`，上游任务在后台创建。
2. **轮询** —— `GET /v1/tasks/{task_id}`（[查询任务状态](/docs/cn/api-manual/task-management/get-task-detail)）。上游公布生图与编辑平均约 40 秒；每 3–5 秒轮询一次，客户端超时建议设为约 20 分钟；任务仍为 `processing` 时不要重复提交同一提示词。上游按机构号限制并发，超出时本平台会自动退避重投，用户侧表现为任务耗时变长而非失败。
3. **读取结果** —— `status` 为 `completed` 时，`results` 中为图片 URL：`fast` 为 4 张，`draft` 为 24 张。`usage.cost` 为最终扣费。
4. **保存图片** —— 结果链接是签名 OSS 链接，有效期 **30 天**，且签名只对 `GET` 有效，用 `HEAD` 探活会返回 `403`。需要保留的图片请自行下载或重新托管。
5. **可选回调** —— 传入 `callback_url`（HTTPS、公网可达）即可在 `completed` / `failed` 时收到通知。回调会退避重试 3 次；请把回调当作提示，并以任务查询为准。

| 状态 | 含义 | 是否终态 |
| - | - | - |
| `pending` | 已受理，等待上游队列 | 否 |
| `processing` | 渲染中 | 否 |
| `completed` | 图片已就绪，见 `results` | 是 |
| `failed` | 上游错误、参数被拒、内容审核或图片拉取失败；报错信息在 `error` 中，预扣积分全额退还 | 是 |

失败任务全额退款，包括创建阶段被拒、上游参数拒绝（`--oref`、超范围的 `--q`、描述过长）、图片拉取失败，以及上游内容审核拦截了一次任务的**全部**图片。只要至少有 1 张图片通过审核，任务即为 `completed` 并正常计费。错误码与重试建议见[错误码](/docs/cn/api-manual/task-management/error-codes)页面。

### 派生任务

变化、重塑和画布编辑以同一账号下已完成的 `mj-v8.2` 系列任务为源（`task_id` + `image_number`）。以下规则依上游通道文档并经本平台验证：

* 这些派生操作在上游由 Midjourney 的 V7 引擎渲染，结果在风格上可能与源图略有差异；价格不变；不接受 V8.1 源任务。
* `image_number` 选择源图：`fast` 源任务为 `0`–`3`，`draft` 源任务为 `0`–`23`（24 张草图都可作为变化、重塑、编辑的源）。
* `mj-v8.2-upload-paint`、`mj-v8.2-retexture`、`mj-v8.2-remove-bg` 的结果**不能**作为变化、重塑、编辑的源；上游只允许对它们做高清，而本路由不提供该操作。请改用生图、变化、重塑或编辑任务作为源。

***

## 常见问题

**从 V8.1 迁移需要改提示词吗？**
不需要。只改 `model` 的值即可，提示词、`model_params` 和价格均不变。仅 `--oref` / `--ow` 不再可用，且 `--q` 在 `1` 和 `4` 之外还接受 `2` 和 `3`。

**为什么垫图请求在创建任务之前就返回 400？**
上游未能在拉取时限内下载图片。请把文件放到快速、公网可达的图床上，或使用文件上传 API，然后重试。

**有没有 Turbo 档？**
没有。上游文档标注 V8 不支持 turbo，V8.2 与 V8.1 一样只提供 `draft` 和 `fast`。

**`--q 4` 会更慢或更贵吗？**
不另计费。上游把 `4` 描述为高质量模式，渲染时间更久。

**V8.2 的图片可以放大吗？**
V8.2 没有放大接口。请改用 `quality: "hd"` 生成原生 2K 输出。

***

## 内容审核说明

<Note>
  Midjourney 内置内容审核机制，逐张审核：若部分生成图像被过滤，任务仍为 `completed`，其余图片正常返回，按正常价格计费；若**全部**图像被过滤，任务为 `failed`，预扣积分全额退还。请留意提示词的内容合规性。
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.