# MJ 生成、融合与提示词

<a id="mj-imagine"></a>

<a id="imagine-文生图与垫图"></a>

## 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`

```bash
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`

```bash
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 权限为准。

<a id="mj-blend"></a>

<a id="blend-图片混合"></a>

## 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`

```bash
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 权限为准。

<a id="mj-describe"></a>

<a id="describe-图生文"></a>

## Describe 图生文

 **POST**  `/mj/submit/describe`

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

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

 **分析图片**  `POST /mj/submit/describe`

```bash
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`

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

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

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

<a id="mj-shorten"></a>

<a id="shorten-提示词分析"></a>

## Shorten 提示词分析

 **POST**  `/mj/submit/shorten`

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

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

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

```bash
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`

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

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

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