Midjourney 生图 API

Essevin 上的 Midjourney 是异步接口：先提交任务，再轮询 Essevin 任务 ID。请使用 Midjourney 分组的密钥，正式发起付费任务前先用 GET /v1/models 确认准确的模型 ID。

端点

所有请求使用 Authorization: Bearer sk-你的密钥 和 Content-Type: application/json。模型 ID 为 midjourney-v8-2。

请求契约

curl https://api.essevin.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"midjourney-v8-2","prompt":"a red apple on a wooden table, studio light --ar 16:9"}'

尺寸与画幅比例

图片尺寸不是请求字段，而是由提示词里的 --ar 决定，--hd 会以大约两倍的边长原生出图。下表尺寸均为实测值，不是换算得出的——--hd 并不是精确的两倍。

--ar 只接受整数比，--ar 1.5:1 会被拒绝。横竖两个方向的比例都不得超过 14:1，而且 --hd 会把这个上限压到 4:1，所以 --hd --ar 14:1 会被拒绝，--hd --ar 4:1 则出图 4096 × 1184。

提示词参数

下列参数会被接受并透传：

这个模型版本不接受的参数

下列参数在提交时直接返回 400，错误信息里会说明原因。之所以拒绝而不是转发，是因为官方要么静默忽略它们——让你为一个根本没生效的效果付钱——要么在几分钟后把任务判失败。

提交与轮询

提交成功返回 202，任务 ID 在 id 字段，同时返回 images_per_task。查询方式与其他异步媒体任务相同，不要在查询时传计费标头：

  -H "Authorization: Bearer sk-你的密钥"

status 依次经过 queued → processing → completed 或 failed，只有后两者是终态，其他任何值都按进行中处理。完成的任务在 outputs 里带四个输出地址，地址在 console.essevin.com 域名下，是自任务完成起 6 小时有效的签名链接；再次查询返回同一地址、不会续期，过期访问返回 410，请在有效期内下载保存。只有成功完成的任务才计费，失败的任务不计费。

失败情况

价格

Midjourney 按返回的图片张数计费，所以一个任务按所在档位的单价收四张图的费用：默认出图与 --hd 2K 出图分属两个价格档。官方牌价见价格页。你的实际单价以登录后的模型广场为准，每次请求的实际扣费见用量记录。