参数总览
基础参数
宽高比 --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 的七个模型均为异步任务,按次计费。- 提交 ——
POST /v1/images/generations立即返回任务id、status: processing和usage.credits_reserved,上游任务在后台创建。 - 轮询 ——
GET /v1/tasks/{task_id}(查询任务状态)。上游公布生图与编辑平均约 40 秒;每 3–5 秒轮询一次,客户端超时建议设为约 20 分钟;任务仍为processing时不要重复提交同一提示词。上游按机构号限制并发,超出时本平台会自动退避重投,用户侧表现为任务耗时变长而非失败。 - 读取结果 ——
status为completed时,results中为图片 URL:fast为 4 张,draft为 24 张。usage.cost为最终扣费。 - 保存图片 —— 结果链接是签名 OSS 链接,有效期 30 天,且签名只对
GET有效,用HEAD探活会返回403。需要保留的图片请自行下载或重新托管。 - 可选回调 —— 传入
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,预扣积分全额退还。请留意提示词的内容合规性。