curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: mj-v8.2",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Midjourney V8.2

Midjourney V8.2 图像生成

Midjourney V8.2 模型支持通过自然语言提示词生成高质量图像。Fast 模式每次生成 4 张图；Draft 模式单次运行返回 24 张轻量级 512 px 草图
支持文生图和图生图（在 prompt 中引用图片 URL）
输入图片 URL 必须公网可访问且能在约 10 秒内下载完成；上游在创建任务时同步拉取图片，拉取失败会返回 400。中国大陆以外的图床（imgur、ibb、raw.githubusercontent、pinimg、picsum）实测均会失败，请将图片托管在高速 CDN 上或使用平台文件上传
V8.2 亮点：在 V8.1 基础上的美学与画质升级、精细度可在 prompt 中通过原生 --quality / --q 参数（1-4，4 为高质量模式）设置且不加价，以及原生 2K 输出（quality=hd）。V8.2 不提供 Turbo（上游文档标 V8 不支持）
支持风格参考（--sref）；--oref / --cref 在 V8.2 上不支持，会被上游拒绝，详见提示词参数手册
上游不支持的提示词参数会原样透传：任务失败并返回参数错误（invalid_parameters），预扣积分全额退还（不再静默丢弃）
异步处理模式，使用返回的任务ID 进行查询
生成的图像链接有效期为 30 天，请尽快保存
超时时间约 20 分钟
参数说明：本接口固定使用 V8.2，暂不支持 niji；速度模式请通过 model_params.speed 设置，输出质量请通过顶层 quality 参数设置；精细度直接在 prompt 中书写 --quality / --q（1-4），原样透传
mj-v8.2-edit / mj-v8.2-upload-paint 属于画布编辑（img_pos + mask）。上游的指令编辑接口（--edit，最多 4 张参考图）本路由暂未开放，接入排期中

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v8.2",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv82",
  "model": "mj-v8.2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: mj-v8.2",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Midjourney 内置内容审核机制，逐张审核：被过滤的图片不会出现在结果里，其余图片正常返回，结果数量会相应减少；只要有 1 张通过，任务为 completed，按正常价格计费。若全部图片被过滤，任务为 failed，预扣积分全额退还。请留意提示词和参考图的内容合规性。

授权

Authorization

string

header

必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key ：

访问 API Key 管理页面获取您的 API Key

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

默认值:mj-v8.2

必填

模型名称

可用选项:

mj-v8.2

prompt

string

必填

提示词，支持 Midjourney V8.2 全部原生参数语法（如 --ar 16:9 --s 500）。

图生图：在 prompt 开头放置图片 URL，支持格式：.png, .gif, .webp, .jpg, .jpeg

图生图规则：

单图 + 无文字 = 无效（会报错）
单图 + 文字描述 = 有效
多图 + 无文字 = 有效
多图 + 文字描述 = 有效

不支持的参数：上游不支持的参数（如 --oref、--cref、--stop、--bs）会原样透传并被上游明确拒绝：任务失败并返回参数错误（invalid_parameters），预扣积分退还。--v / --version / --niji 以及速度 / hd 类参数会被剥离，改由 API 参数控制；--quality / --q（1-4）原样透传。

Maximum string length: 2048

示例:

"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"

quality

enum<string>

默认值:standard

输出质量

standard：标准分辨率（默认），1 倍倍率
hd：原生 HD 输出，1.5 倍倍率。与 speed: draft 互斥

费用说明：质量倍率与 speed 倍率为相乘关系。

可用选项:

standard,

hd

model_params

object

模型参数

Show child attributes

callback_url

string<uri>

任务完成后的HTTPS回调地址

回调时机：

任务完成（completed）或失败（failed）时触发
在计费确认完成后发送

安全限制：

仅支持HTTPS协议
禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等）
URL长度不超过2048字符

回调机制：

超时时间：10秒
失败后最多重试3次（会分别在失败的1秒/2秒/4秒后进行重试）
回调响应体格式与任务查询接口返回的格式一致
回调地址若返回2xx状态码视为成功，其他状态码会触发重试

示例:

"https://your-domain.com/webhooks/image-task-completed"

响应

任务创建成功

created

integer

任务创建时间戳

示例:

1757165031

string

任务ID

示例:

"task-unified-1757165031-mjv82"

model

string

实际使用的模型名称

示例:

"mj-v8.2"

object

enum<string>

任务的具体类型

可用选项:

image.generation.task

progress

integer

任务进度百分比 (0-100)

必填范围: 0 <= x <= 100

示例:

0

status

enum<string>

任务状态

可用选项:

pending,

processing,

completed,

failed

示例:

"pending"

task_info

object

异步任务信息

Show child attributes

type

enum<string>

任务的输出类型

可用选项:

text,

image,

audio,

video

示例:

"image"

usage

object

使用量和计费信息

Show child attributes

图像系列

视频系列

音频系列

语言系列

账户管理

任务管理

文件管理

Midjourney V8.2 图像生成

授权

请求体

响应