# 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` | 依赖代码分享权限与模型兼容性，不等同于数字风格码 |

各字段的数量、权重、版本与组合限制统一见[参考参数表](https://api.hamubox.com/docs/models/midjourney/#参考图风格与角色)。不要把 V6 的角色参考配置直接用于 V8 或 Niji V7。

## 提供图片与代码

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

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

通过提示词尾部提供参数时，遵循[原生格式与优先级](https://api.hamubox.com/docs/models/midjourney/#原生提示词格式)。不要同时在多个位置放置不同的参考图或代码，除非明确希望尾随参数覆盖 JSON。

## 引用人物不等于直接编辑

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

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

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

继续阅读：[完整参数](https://api.hamubox.com/docs/models/midjourney/) · [估价与提交](https://api.hamubox.com/docs/midjourney/quickstart/) · [常见问题](https://api.hamubox.com/docs/midjourney/faq/)。