MJ 生成、融合与提示词

Imagine 文生图与垫图

POST /mj/submit/imagine

提交文字提示词，可同时提供参考图片。比例和版本等 MJ 参数写在 prompt 内。

参数	类型	必填	说明
`prompt`	`string`	是	非空提示词，例如 a cat in sunlight --ar 16:9。版本参数及可用版本以本站模型说明为准。
`base64Array`	`string[]`	否	参考图 Data URL 数组；本站传入时要求 1–10 项，省略表示纯文生图。
`state`	`string`	否	调用方业务标识，随任务返回；不是任务 ID，也不提供幂等去重。
`notifyHook`	`string`	否	本站暂未开放回调，请省略。传非空值会被拒绝。

纯文字生图POST /mj/submit/imagine

curl --fail-with-body -X POST 'https://y.junlistudio.com/mj/submit/imagine' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "prompt": "a cat in sunlight --ar 16:9",
  "state": "order-123"
}'

带参考图生图POST /mj/submit/imagine

curl --fail-with-body -X POST 'https://y.junlistudio.com/mj/submit/imagine' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "prompt": "turn the reference into a watercolor --ar 1:1",
  "base64Array": [
    "data:image/png;base64,REPLACE_WITH_IMAGE_BASE64"
  ],
  "state": "reference-123"
}'

返回：返回通用提交回执；保存 result，轮询新任务。

不传 model、n、size、response_format。--ar 等参数不拆成自定义 JSON 字段。

生成四宫格仍是一次 Imagine 动作；要得到其中一张放大图，请在完成后执行对应 U 按钮。

计费：mj_imagine。动作是否开放及价格，以本站模型目录和当前 Key 权限为准。

Blend 图片混合

POST /mj/submit/blend

将 2–5 张参考图混合生成新图。

参数	类型	必填	说明
`base64Array`	`string[]`	是	2–5 个图片 Data URL；不要传图片 URL。
`dimensions`	`string`	是	PORTRAIT = 2:3，SQUARE = 1:1，LANDSCAPE = 3:2。
`state`	`string`	否	调用方业务标识，随任务返回；不是任务 ID，也不提供幂等去重。

两图混合POST /mj/submit/blend

curl --fail-with-body -X POST 'https://y.junlistudio.com/mj/submit/blend' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "base64Array": [
    "data:image/png;base64,REPLACE_WITH_IMAGE_BASE64",
    "data:image/jpeg;base64,REPLACE_WITH_SECOND_IMAGE_BASE64"
  ],
  "dimensions": "LANDSCAPE",
  "state": "blend-123"
}'

返回：返回通用提交回执；保存 result，轮询新任务。

此接口不接受 prompt、size 或自定义 aspect_ratio；构图比例由 dimensions 指定。

计费：mj_blend。动作是否开放及价格，以本站模型目录和当前 Key 权限为准。

Describe 图生文

POST /mj/submit/describe

上传一张图片，异步获取提示词分析。

参数	类型	必填	说明
`base64`	`string`	是	单个图片 Data URL，不是 base64Array 数组，也不是纯 Base64。
`state`	`string`	否	调用方业务标识，随任务返回；不是任务 ID，也不提供幂等去重。

分析图片POST /mj/submit/describe

curl --fail-with-body -X POST 'https://y.junlistudio.com/mj/submit/describe' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "base64": "data:image/png;base64,REPLACE_WITH_IMAGE_BASE64",
  "state": "describe-123"
}'

返回：返回通用提交回执；保存 result，轮询新任务。

完成后任务 properties 字段（节选）GET /mj/task/{id}/fetch

{
  "properties": {
    "finalPrompt": "1. Suggested prompt ...",
    "finalZhPrompt": "1. 中文提示词建议……"
  }
}

完成后读取 properties.finalPrompt 和 properties.finalZhPrompt；以实际返回为准。该动作不保证返回 imageUrl。

计费：mj_describe。动作是否开放及价格，以本站模型目录和当前 Key 权限为准。

Shorten 提示词分析

POST /mj/submit/shorten

分析较长提示词，返回精简建议。

参数	类型	必填	说明
`prompt`	`string`	是	要分析的非空提示词。
`botType`	`string`	是	MID_JOURNEY 或 NIJI_JOURNEY，不能省略。
`state`	`string`	否	调用方业务标识，随任务返回；不是任务 ID，也不提供幂等去重。

精简提示词POST /mj/submit/shorten

curl --fail-with-body -X POST 'https://y.junlistudio.com/mj/submit/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "prompt": "a quiet library with warm afternoon light and wooden shelves",
  "botType": "MID_JOURNEY",
  "state": "shorten-123"
}'

返回：返回通用提交回执；保存 result，轮询新任务。

完成后任务 properties 字段（节选）GET /mj/task/{id}/fetch

{
  "properties": {
    "finalPrompt": "1. Suggested prompt ...",
    "finalZhPrompt": "1. 中文提示词建议……"
  }
}

完成后读取 properties.finalPrompt / properties.finalZhPrompt；不要把文字分析结果当图片下载。

计费：mj_shorten。动作是否开放及价格，以本站模型目录和当前 Key 权限为准。