MJ

接口

密钥从 YOUCHUAN_API_KEY 环境变量读取，值为 YunQi API 密钥。生成请求的 model 可为 mj_imagine 或 youchuan-image，两个名称都可调用同一 MJ 接口；提示词字段为 text，版本参数放在 text 中。

Authorization: Bearer <YOUCHUAN_API_KEY>
Content-Type: application/json
Accept: application/json

不使用 x-api-key、x-goog-api-key、x-youchuan-secret 或 x-youchuan-app。环境变量名称不是请求头。/v1/tob/subscribe 不用于生成图片。

密钥需要开通对应的 MJ 图片权限。创建密钥时选择包含目标能力的分组，避免使用仅包含文本模型的分组。

版本与质量

显式指定 --v 或 --niji，二者不同时使用。本接口未指定版本时默认 v7；不要套用 Midjourney 网站的默认版本。

--q 不是 OpenAI Images 的 quality=low/medium/high，也不是输出像素尺寸。质量参数不承诺每个画面的视觉效果逐档提升；请求受理或参数回显不能独立证明底层计算档位。

生成参数

以下参数均写在 text 末尾，参数前留空格，末尾不加逗号或句号。不要将 size、n、quality、aspectRatio、response_format 放进 JSON 请求体。text 长度为 1–8192 字符；v8 系列正文不超过 1024 字符，不含图片引用与参数。

通用参数不代表每个历史版本都支持。V8.1/V8.2 的 SD 最大比例为 14:1、HD 为 4:1，含纵向对称比例。不要自动改变客户选定的模型、质量或模式重试。

组合约束

• --fast 与 --turbo 不同时使用；niji 7 不发送 --q。
• v7 的 --draft 不与 --tile、--oref 组合；--oref 不与 --q 4 组合。draft 请求不附加 --q 4，不据此承诺草图的质量档位。
• --hd 仅用于 v8.1 / v8.2，不能追加到旧版本。
• 结果数量以 urls 为准，不固定假设四张，不用 JSON 的 n 控制。

以上只展示语法，配置由调用方选择。操作类型与生成模式会影响费用，具体倍率见下节。

计费规则

MJ 按任务计费，不按返回图片数量直接相乘；二次操作创建的新任务另行计费。mj_imagine 与 youchuan-image 均按各自控制台定价及以下适用倍率计算。

任务费用 = 基础任务价格 × 操作倍率 × Turbo 倍率 × Draft 倍率 × HD 倍率。基础价格、币种与账户分组折扣以控制台为准；多个条件同时满足时，倍率相乘。

例如普通 v7 生成为 1×、v7 draft 为 0.5×、v8.1/v8.2 HD 为 1.5×、HD 加 Turbo 为 3×，均相对于基础任务价格，并以参数组合可用为前提。v5 专用 upscale type=2/3 的价格单独查看控制台。

本规则没有为 --q 或 --ar 单独设置附加倍率，q4 不等于四倍费用。cost.fastCost、cost.feeCost 不直接当作客户币种金额；实际扣费及失败任务结算以控制台账单为准。

任务流程

提交后保存响应 id，用同一密钥查询任务。status=1 执行中，status=2 成功，status=3 失败。只有成功状态且存在有效 urls，才进入下载和后续操作。

{
  "id": "TASK_ID",
  "status": 1,
  "comment": "执行中",
  "urls": [],
  "cost": {
    "fastCost": 1,
    "feeCost": 60
  }
}

六分钟是客户端等待预算，不代表任务已取消或生成时长承诺。超时后保留 id 恢复查询；提交超时但没有 id 时先核对控制台或联系客服，不自动重复提交。

imageNo 从 0 开始，使用原始 urls 数组位置，不对过滤后的数组重新编号。图片二次操作返回新的任务 id，需要单独查询。

签名下载链接完整保留查询参数，及时保存文件。向存储地址下载时不附带 YunQi API 密钥。空链接和审核受限项不计为可用结果。

图片操作

以下路径前缀均为 /v1/tob/，方法为 POST。jobId 为已完成的源任务 ID，imageNo 为源图片编号。选填字段用问号标注。

高级编辑和转绘的结果仅支持继续执行高清操作。不要将 GPT Images 的任务、图片索引或蒙版格式直接套入 MJ。

参考图与画布

单张或多张图片 URL 放在 text 开头，后接提示词；URL 必须能由服务端直接读取，不能是本机路径或需要登录的网页。不要使用裸 Base64 代替 URL。

{
  "model": "mj_imagine",
  "text": "IMAGE_URL_1 IMAGE_URL_2 A blue mug on a red table --iw 1 --ar 3:2 --v 7"
}

参考图使用 PNG、JPEG、WebP 或 GIF 的 HTTP(S) 直链。优先使用稳定公开地址；签名 URL 则需保留完整查询参数并覆盖任务读取时段。sv 是风格算法版本，不是主模型版本。参考图不是可编辑图层，不保证逐像素保留主体。

canvas 为编辑画布宽高，结果可能按模型规格缩放；imgPos 为原图在新画布中的宽高和左上角位置。mask.areas 的 width / height 为原图尺寸，points 按 x、y 成对排列。也可用同尺寸黑白蒙版 URL，白色为重绘区域。

{
  "jobId": "SOURCE_TASK_ID",
  "imageNo": 0,
  "canvas": {
    "width": 1280,
    "height": 1024
  },
  "imgPos": {
    "width": 1024,
    "height": 1024,
    "x": 128,
    "y": 0
  },
  "remixPrompt": "Extend the white tabletop around the blue mug"
}

提交示例

{
  "model": "mj_imagine",
  "text": "现代东方建筑，清晨薄雾，电影级建筑摄影，无文字 --v 8.1 --fast --hd --q 4 --raw --ar 16:9"
}

完整 Python 客户端从 YOUCHUAN_API_KEY 读取密钥，先保存任务 id，再轮询和下载；支持按原任务恢复。JSON 示例中的图片 URL 和任务 ID 需替换成自己的实际值。

完整参数、各操作请求体与可恢复的 Python 示例。

图片保存

任务完成后立即遍历 urls，保存为 mj-imagine-任务ID-原始序号.png。完整示例会实际编码为 PNG，并记录每张图片的下载结果；单张失败仍处理其他图片，恢复下载不再次生成。

悠船存储说明的上游默认留存为 30 天；这不是签名 URL 的有效期或永久存储承诺。客户应自行保存文件，下载存储链接时不要附带 API 密钥。