跳转到主要内容
POST
/
v1
/
midjourney
/
generations
curl --request POST \
  --url https://api.apimart.ai/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"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/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 行为一致。
项目内容
actionIMAGINE
计费midjourney@imagine[-version][-speed]
必填prompt
可选image_urls、Prompt 参数、speedmetadata

请求参数

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

结构化参数(可选)

以下参数可以写在 body 里,也可以直接写在 prompt 中(如 --ar 16:9)。body 优先级高于 prompt。
字段类型等价 MJ 参数说明
sizestring--ar宽高比,如 "16:9", "1:1", "9:16"
qualitystring--q质量:"0.25", "0.5", "1", "2"
stylestring--style风格:"raw"
versionstring--v版本号。主版本会追加为 --v <version>;与 niji: true 搭配 "7" / "6" 时会归一化为 Niji 版本
seedint--seed随机种子
negative_promptstring--no负面提示词,如 "ugly, blurry"
stylizeint--s风格化强度 (0-1000)
chaosint--c混乱度 (0-100)
weirdint--w怪异度 (0-3000)
tilebool--tile平铺模式
nijibool--nijiNiji 开关。推荐传 niji: true + version: "7" / "6"
iwfloat--iw图片权重 (0-3),垫图时使用
cwint--cw角色权重 (0-100)
swint--sw风格权重 (0-1000)
crefstring--cref角色参考图 URL
srefstring--sref风格参考图 URL
drefstring--dref深度参考图 URL
dwfloat--dw深度权重 (0-100)
repeatint--repeat重复生成次数 (2-40)
rawbool--raw原始风格 (v5.1+ 支持)
draftbool--draft草图模式 (v7+ 支持)
hdbool--hdHD 高清 (仅 v8 / v8.1,未传 version 时后端自动补 --v 8.1)
stopint--stop提前停止 (10-100,仅 v5-6.1 / niji 5-6)
extrastring任意 --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.176.15.25.1niji 7niji 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"
  }]
}
成功后通过任务查询轮询结果。