获取 API Key 获取 API
文档

Imagine(文生图)

Midjourney 文生图 / 垫图。默认入口 /v1/midjourney/generations 与显式入口 /imagine 行为一致

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/midjourney/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "a beautiful sunset over mountains",
    "size": "16:9",
    "version": "6.1",
    "speed": "fast"
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

默认文生图 / 垫图接口,等同于 imagine。显式入口 /v1/midjourney/generations/imagine 行为一致。

项目 内容
action IMAGINE
计费 midjourney@imagine[-version][-speed]
必填 prompt
可选 image_urls、Prompt 参数、speed、metadata

请求参数

字段 类型 必填 说明
prompt string 是 提示词,支持原生 MJ 参数(如 --ar 16:9 --v 6.1)
speed string 否 速度模式:relax(默认)/ fast / turbo
image_urls string[] 否 垫图 URL(图生图场景),支持 URL 或 base64
metadata object 否 自定义元数据,会随任务保存,便于业务侧追踪

结构化参数(可选)

以下参数可以写在 body 里,也可以直接写在 prompt 中(如 --ar 16:9)。body 优先级高于 prompt。

字段 类型 等价 MJ 参数 说明
size string --ar 宽高比,如 "16:9", "1:1", "9:16"
quality string --q 质量:"0.25", "0.5", "1", "2"
style string --style 风格:"raw" 等
version string --v 版本号。主版本会追加为 --v <version>;与 niji: true 搭配 "7" / "6" 时会归一化为 Niji 版本
seed int --seed 随机种子
negative_prompt string --no 负面提示词,如 "ugly, blurry"
stylize int --s 风格化强度 (0-1000)
chaos int --c 混乱度 (0-100)
weird int --w 怪异度 (0-3000)
tile bool --tile 平铺模式
niji bool --niji Niji 开关。推荐传 niji: true + version: "7" / "6"
iw float --iw 图片权重 (0-3),垫图时使用
cw int --cw 角色权重 (0-100)
sw int --sw 风格权重 (0-1000)
cref string --cref 角色参考图 URL
sref string --sref 风格参考图 URL
dref string --dref 深度参考图 URL
dw float --dw 深度权重 (0-100)
repeat int --repeat 重复生成次数 (2-40)
raw bool --raw 原始风格 (v5.1+ 支持)
draft bool --draft 草图模式 (v7+ 支持)
hd bool --hd HD 高清 (仅 v8.1 / v8.2,未传 version 时后端自动补 --v 8.1)
stop int --stop 提前停止 (10-100,仅 v5-6.1 / niji 5-6)
extra string 任意 --xxx 逃生口,原样追加到 prompt 末尾

示例

方式一:参数写在 prompt 里

{
  "prompt": "a beautiful sunset over mountains --ar 16:9 --v 6.1 --style raw --s 750"
}

方式二:参数写在 body 里(推荐)

{
  "prompt": "a beautiful sunset over mountains",
  "size": "16:9",
  "version": "6.1",
  "style": "raw",
  "stylize": 750
}

主版本与 Niji 版本

{
  "prompt": "anime girl in a moonlit garden",
  "niji": true,
  "version": "7",
  "size": "9:16"
}

线上已验证可用版本:8.2、8.1、7、6.1、5.2、5.1、niji 7、niji 6。主版本使用 body 字段 version;Niji 推荐传 niji: true + version: "7" / "6",计费版本会归一化为 niji7 / niji6。

方式三:混合使用(body 优先)

{
  "prompt": "a beautiful sunset --ar 1:1",
  "size": "16:9"
}

最终 prompt: a beautiful sunset --ar 16:9(body 中的 size 覆盖了 prompt 中的 --ar 1:1)

图生图(垫图)

{
  "prompt": "turn this product into a luxury studio photo",
  "image_urls": ["https://example.com/product.png"],
  "size": "1:1",
  "iw": 1.2
}

Fast 模式

{
  "prompt": "a cute cat",
  "speed": "fast"
}

speed=relax 或未传 speed 时不追加计费 speed 后缀;fast / turbo 会通过对应速度通道生效,并匹配对应计费 key。

响应

{
  "code": 200,
  "data": [{
    "status": "submitted",
    "task_id": "task_01JWXXXXXXXXXXXX"
  }]
}

成功后通过任务查询轮询结果。