Midjourney API 参考图与风格码

Midjourney 的普通参考图、风格参考和角色参考用途不同，不应把所有图片都放到同一个字段。参考图只参与引导，不保证精确复制原图、构图或角色细节。

选择参考方式

目标	请求字段	需要注意
参考图片内容、构图或整体感觉	`images`	生成时是图片参考，不会自动切换成编辑
参考画风、质感与配色	`style_references` / `style_codes`	图片 URL 与数字风格码不同；权重用 `style_weight`
角色参考	`character_references`	仅 V6、V6.1、Niji V6，权重用 `character_weight`
Omni Reference	`omni_reference`	仅 V7 Standard；还需当前服务已开放对应档位
使用公开个性化或情绪版代码	`profile_codes`	依赖代码分享权限与模型兼容性，不等同于数字风格码

各字段的数量、权重、版本与组合限制统一见参考参数表。不要把 V6 的角色参考配置直接用于 V8 或 Niji V7。

图片字段填写上游可下载的 HTTP(S) URL，不使用浏览器 blob:、本地路径或图片 Base64。需要上传时，先调用素材上传接口，再把返回的 URL 放入参考字段。

结构化 style_codes 只填写数字风格码，不加 --sref 前缀；profile_codes 填写明确的公开代码，不加 --p。风格码不是模型 ID，也不是情绪版名称。

通过提示词尾部提供参数时，遵循原生格式与优先级。不要同时在多个位置放置不同的参考图或代码，除非明确希望尾随参数覆盖 JSON。

generate 加参考图会创建新画面；“保持底图，只修改衣服”等编辑需求属于另一种操作。参数契约列出了 edit 等字段，但不能据此假定当前线路支持完整官网编辑器。只有对应模型、操作和价格都可用时才应提交。

V7 Standard 可以同时传 omni_reference、omni_weight 和 profile_codes。Fast / Relax 沿用对应的 Omni 报价；个性化不另加价。工作台选择“全能参考”后，可在“情绪版 / 个性化代码”中填写公开代码，画布使用同样的设置。

公开个性化代码同样不代表可以访问他人的私有情绪版。平台情绪版的创建和管理不属于本公共 API 的开放范围。组合能力不包括 Niji、Draft、HD，也暂不接受 style_weight 或 style_version。