Skip to main content

参数总览

以下两项设置不写在 prompt 里,而是通过 API 参数控制(写在 prompt 中无效,会被剥离):
  • 速度(draft / fast)→ model_params.speed
  • 输出质量(standard / hd)→ 顶层 quality 参数
--v / --version 固定为 V8.2,不支持 --niji。详见下文速度模式与输出质量。

基础参数

宽高比 --ar

设置图像的宽高比,仅支持整数比,小数会被拒绝(请写 139:100,不要写 1.39:1)。极端比例属实验性,效果可能不稳定。
常见值:1:1、4:3、3:2、16:9、9:16、2:3。像素尺寸见输出质量。

混沌 --chaos / --c

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

风格化 --stylize / --s

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

实验参数 --exp

与 --stylize 类似但可叠加,生成更详细、动态、创意的图像。
  • 推荐值:5、10、25、50、100
  • 5-50 效果变化明显,50-100 变化较小
  • 超过 25–50 时可能覆盖 --stylize 与 --p 的效果;组合使用时请调低取值

质量 --quality / --q

设置图像细节程度。取值 1 - 4,默认 1;4 为高质量模式。该参数会原样透传给上游,不改变价格。
  • V8.2 接受 1 / 2 / 3 / 4;V8.1 仅接受 1 / 4。超出范围的值会被拒绝:任务失败,错误信息会点名 --quality 及其允许的取值,预扣积分退还
  • 取值越高渲染越久
  • 仅生图接口可用;派生任务(变化、重塑、编辑等)继承源图

原始模式 --raw

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

反向提示词 --no

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

种子 --seed

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

图像引用参数

图像提示(垫图)

在提示词开头放置图片 URL,用图片影响生成内容。
有效组合规则:
  • 最多 20 张垫图
  • 支持格式:.png、.gif、.webp、.jpg、.jpeg;单张 ≤20 MB、边长 ≤16k 像素
  • 纯图无文字的提示词与 --stylize / --weird 不兼容
  • draft 速度下同样可用(已在本平台验证);只有 --tile 不能与 draft 同用
  • URL 必须能在几秒内公开访问,详见输入图片要求

图像权重 --iw

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

风格参考 --sref

匹配参考图的视觉风格(颜色、纹理、光照),不复制内容。必须配合文本提示词使用。
  • 支持多张:--sref URL1 URL2;可用 --sref URL1::2 URL2::1 指定相对权重(悠船文档支持,本平台未实测)
  • 支持随机风格:--sref random(生成后返回数字代码,可重用)
  • 最多 20 个 sref
  • 文本提示词只描述内容,不写指令(写”一只猫”,不要写”让它看起来像参考图”)

风格权重 --sw

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

个性化 --p

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

速度模式

速度模式通过 API 的 model_params.speed 字段控制(请勿在提示词中写 --draft / --fast)。 各路由的取值:生图接受 draft / fast;重塑、画布编辑、转绘、上传重绘只接受 fast;变体与去背景没有 speed 字段(变体传 speed: fast 会被接受并忽略,其它值返回 400)。
与 V7 不同,V8.2 的 draft 模式不减半收费——它与 fast 使用相同倍率。草图模式单次运行返回 24 张小图,挑出喜欢的再以完整质量重跑。草图模式不能与 hd 质量或 --tile 同用(--oref 在 V8.2 上完全不支持)。**V8.2 不提供 Turbo。**上游通道文档标注 V8 不支持极速模式,所有 V8.2 端点的 speed: "turbo" 都返回 400(与 V8.1 相同)。

输出质量

输出分辨率通过顶层 quality 参数控制,而非提示词参数。请勿在提示词中写 --hd。
  • 质量倍率与速度倍率是相乘关系
  • hd 与 draft 速度互斥
  • V8.2 没有独立的高清(放大)接口;上游对 V8 的”高清”就是用 hd 重新生成一次,需要 2K 输出时请直接使用 quality: "hd"

提示词长度限制

描述过长会被拒绝:任务失败并返回参数错误(invalid_parameters),预扣积分退还。

依赖关系

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

冲突关系


V8.2 不支持的参数

V8.2 只剥离会破坏版本锁定或计费的参数,其余参数一律原样透传给上游。若上游不支持某个参数,任务会失败并返回参数错误(invalid_parameters),预扣积分全额退还——不会再静默丢弃。
上游通道(悠船)已为 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 都会被上游拒绝。

输入图片要求

以下规则适用于垫图、--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上传并使用返回的 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 同用会被上游拒绝。

提示词格式规范

基本结构

书写规则

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

示例


任务流程

V8.2 的七个模型均为异步任务,按次计费。
  1. 提交 —— POST /v1/images/generations 立即返回任务 id、status: processing 和 usage.credits_reserved,上游任务在后台创建。
  2. 轮询 —— GET /v1/tasks/{task_id}(查询任务状态)。上游公布生图与编辑平均约 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 次;请把回调当作提示,并以任务查询为准。
失败任务全额退款,包括创建阶段被拒、上游参数拒绝(--oref、超范围的 --q、描述过长)、图片拉取失败,以及上游内容审核拦截了一次任务的全部图片。只要至少有 1 张图片通过审核,任务即为 completed 并正常计费。错误码与重试建议见错误码页面。

派生任务

变化、重塑和画布编辑以同一账号下已完成的 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 输出。

内容审核说明

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