> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialvision.tisyk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Midjourney 接口参考

> Midjourney Imagine、Blend、Action、Describe 异步生图任务

## 提交shorten 任务

`GET /mj/submit/shorten`

### 请求体参数 (Body)

<ParamField body="botType" type="string">
  bot 类型，mj(默认)或 niji
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址, 为空时使用全局notifyHook
</ParamField>

<ParamField body="prompt" type="string" required>
  待分析/精简的提示词
</ParamField>

<ParamField body="state" type="string">
  自定义参数
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/mj/submit/shorten" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "success",
  "result": "1720000000000000"
}
```

***

## 根据任务ID 查询任务状态

`GET /mj/task/{id}/fetch`

查询 `POST /mj/submit/imagine`、`/mj/submit/action` 等提交的任务当前状态与结果；`status` 为 `SUCCESS` 时 `imageUrl` 有效，`buttons` 给出可执行的后续 Action（`customId`）。

### 请求参数 (Query / Path)

<ParamField path="id" type="string" required>
  任务 ID
</ParamField>

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/mj/task/{id}/fetch" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "action": "IMAGINE",
  "botType": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U1",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::upsample::2::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U2",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::upsample::3::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U3",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::upsample::4::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U4",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::reroll::0::3785da15-4f70-4034-9128-f3ff1ac634fa::SOLO",
      "emoji": "🔄",
      "label": "",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::1::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V1",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::2::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V2",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::3::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V3",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::4::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V4",
      "style": 2,
      "type": 2
    }
  ],
  "customId": "",
  "description": "Submit success",
  "failReason": "",
  "finishTime": 1730621855817,
  "id": "1730621826053455",
  "imageUrl": "https://cdnmjp.oneabc.org/attachments/1300842274347028520/1302547211321741343/kennedyhernandez46715_74108_pig_3785da15-4f70-4034-9128-f3ff1ac634fa.png?ex=6728831f&is=6727319f&hm=f6d701914d608e4da9298d2290b3616317264a70635fbf08a37ca6c1bb671b50&",
  "maskBase64": "",
  "progress": "100%",
  "prompt": "pig --v 6.1",
  "promptEn": "pig --v 6.1",
  "properties": {
    "finalPrompt": "pig --v 6.1",
    "finalZhPrompt": ""
  },
  "startTime": 1730621828024,
  "state": "",
  "status": "SUCCESS",
  "submitTime": 1730621826053
}
```

***

## 获取任务图片的seed

`GET /mj/task/{id}/image-seed`

获取指定任务生成图片的 seed 值（随机数种子），可用于以相同种子复现或微调生成结果。

### 请求参数 (Query / Path)

<ParamField path="id" type="string" required>
  路径中的资源 / 任务 ID
</ParamField>

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl "https://socialvision.tisyk.xyz/mj/task/{id}/image-seed" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"
```

### 响应示例 (200 OK)

```json theme={null}
{
  "action": "IMAGINE",
  "botType": "",
  "buttons": [
    {
      "customId": "MJ::JOB::upsample::1::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U1",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::upsample::2::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U2",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::upsample::3::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U3",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::upsample::4::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "U4",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::reroll::0::3785da15-4f70-4034-9128-f3ff1ac634fa::SOLO",
      "emoji": "🔄",
      "label": "",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::1::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V1",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::2::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V2",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::3::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V3",
      "style": 2,
      "type": 2
    },
    {
      "customId": "MJ::JOB::variation::4::3785da15-4f70-4034-9128-f3ff1ac634fa",
      "emoji": "",
      "label": "V4",
      "style": 2,
      "type": 2
    }
  ],
  "customId": "",
  "description": "Submit success",
  "failReason": "",
  "finishTime": 1730621855817,
  "id": "1730621826053455",
  "imageUrl": "https://cdnmjp.oneabc.org/attachments/1300842274347028520/1302547211321741343/kennedyhernandez46715_74108_pig_3785da15-4f70-4034-9128-f3ff1ac634fa.png?ex=6728831f&is=6727319f&hm=f6d701914d608e4da9298d2290b3616317264a70635fbf08a37ca6c1bb671b50&",
  "maskBase64": "",
  "progress": "100%",
  "prompt": "pig --v 6.1",
  "promptEn": "pig --v 6.1",
  "properties": {
    "finalPrompt": "pig --v 6.1",
    "finalZhPrompt": ""
  },
  "startTime": 1730621828024,
  "state": "",
  "status": "SUCCESS",
  "submitTime": 1730621826053
}
```

***

## 人脸替换（InsightFace Swap）

`POST /mj/insight-face/swap`

将目标图像中的人脸替换为源图像中的人脸。

### 请求体参数 (Body)

<ParamField body="notifyHook" type="string">
  回调地址
</ParamField>

<ParamField body="sourceBase64" type="string" required>
  源人脸图片 Base64（提供人脸的图片）
</ParamField>

<ParamField body="state" type="string">
  自定义透传状态
</ParamField>

<ParamField body="targetBase64" type="string" required>
  目标图片 Base64（需要替换人脸的图片）
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/insight-face/swap" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": "1743326750223591"
}
```

***

## 执行Action动作

`POST /mj/submit/action`

官方文档：[https://docs.midjourney.com/hc/en-us/articles/32804058614669-Upscalers](https://docs.midjourney.com/hc/en-us/articles/32804058614669-Upscalers)

对已有任务执行 Upscale（放大）、Variation（变体）、Reroll（重绘）、Pan（平移）等操作。

### 请求体参数 (Body)

<ParamField body="chooseSameChannel" type="boolean">
  是否选择同一频道下的账号，默认只使用任务关联的账号
</ParamField>

<ParamField body="customId" type="string" required>
  动作标识
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址, 为空时使用全局notifyHook
</ParamField>

<ParamField body="state" type="string">
  自定义参数
</ParamField>

<ParamField body="taskId" type="string" required>
  任务ID
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "botType": "MID_JOURNEY",
  "customId": "MJ::JOB::upsample::1::xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "taskId": "1743326750223591"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/action" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "botType": "MID_JOURNEY",
  "customId": "MJ::JOB::upsample::1::xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "taskId": "1743326750223591"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}
```

***

## 提交Blend任务

`POST /mj/submit/blend`

官方文档：[https://docs.midjourney.com/hc/en-us/articles/32635189884557-Blend-Images-on-Discord](https://docs.midjourney.com/hc/en-us/articles/32635189884557-Blend-Images-on-Discord)

将多张图像混合生成新图像，需提供 2–5 张图片的 Base64 数据。

### 请求参数 (Query / Path)

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="base64Array" type="array">
  图片 base64 数组，需 2\~5 张
</ParamField>

<ParamField body="botType" type="string" required>
  bot类型，mj(默认)或niji
</ParamField>

<ParamField body="dimensions" type="string">
  比例: PORTRAIT(2:3); SQUARE(1:1); LANDSCAPE(3:2)
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址, 为空时使用全局notifyHook
</ParamField>

<ParamField body="quality" type="string">
  将生成的图像的质量。`hd`创建具有更精细细节和更高一致性的图像。此参数仅支持`dall-e-3`.
</ParamField>

<ParamField body="state" type="string">
  自定义参数
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "base64Array": [
    "data:image/png;base64,xxx1",
    "data:image/png;base64,xxx2"
  ],
  "botType": "MID_JOURNEY",
  "dimensions": "SQUARE",
  "notifyHook": "",
  "state": ""
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/blend" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "base64Array": [
    "data:image/png;base64,xxx1",
    "data:image/png;base64,xxx2"
  ],
  "botType": "MID_JOURNEY",
  "dimensions": "SQUARE",
  "notifyHook": "",
  "state": ""
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}
```

***

## 提交 Change（Pan / Zoom）任务

`POST /mj/submit/change`

对已有图像执行 Pan（扩展方向）或 Zoom Out（扩展画面）操作。

### 请求体参数 (Body)

<ParamField body="action" type="string" required>
  操作类型
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址
</ParamField>

<ParamField body="state" type="string">
  自定义透传状态
</ParamField>

<ParamField body="taskId" type="string" required>
  原任务 ID
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "action": "PAN_RIGHT",
  "taskId": "1743326750223591"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/change" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "PAN_RIGHT",
  "taskId": "1743326750223591"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": "1743326750223591"
}
```

***

## 提交Describe任务

`POST /mj/submit/describe`

官方文档：[https://docs.midjourney.com/hc/en-us/articles/32497889043981-Describe](https://docs.midjourney.com/hc/en-us/articles/32497889043981-Describe)

分析一张图片并生成四条文字描述（反向提示词），可用于后续 imagine。

### 请求参数 (Query / Path)

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="base64" type="string">
  用于生成描述（Describe）的 Base64 图片数据，格式为 `data:image/png;base64,&lt;data&gt;`。
</ParamField>

<ParamField body="botType" type="string" required>
  bot类型，mj(默认)或niji
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址, 为空时使用全局notifyHook
</ParamField>

<ParamField body="state" type="string">
  自定义参数
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "base64": "data:image/png;base64,iVBORw0KGgo...",
  "botType": "MID_JOURNEY",
  "notifyHook": "",
  "state": ""
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/describe" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "base64": "data:image/png;base64,iVBORw0KGgo...",
  "botType": "MID_JOURNEY",
  "notifyHook": "",
  "state": ""
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}
```

***

## 图像局部编辑（Edits）

`POST /mj/submit/edits`

在已有图像基础上，通过遮罩区域进行局部编辑，支持 prompt 指导。

### 请求体参数 (Body)

<ParamField body="maskBase64" type="string">
  遮罩 Base64（白色区域为编辑区域）
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址
</ParamField>

<ParamField body="prompt" type="string" required>
  编辑区域的新提示词
</ParamField>

<ParamField body="state" type="string">
  自定义透传状态
</ParamField>

<ParamField body="taskId" type="string" required>
  原任务 ID
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/edits" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": "1743326750223591"
}
```

***

## 提交Imagine任务

`POST /mj/submit/imagine`

官方文档：[https://docs.midjourney.com/hc/en-us/articles/32023408776205-Prompt-Basics](https://docs.midjourney.com/hc/en-us/articles/32023408776205-Prompt-Basics)

根据文本提示词生成图像，支持垫图（base64Array）和多机器人类型。

### 请求参数 (Query / Path)

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="accountFilter" type="object">
  账号筛选条件（可选）
</ParamField>

<ParamField body="base64Array" type="array">
  垫图 Base64 列表，格式 `data:image/png;base64,...`，最多 5 张
</ParamField>

<ParamField body="botType" type="string">
  机器人类型；NIJI 适合动漫风格
</ParamField>

<ParamField body="notifyHook" type="string">
  任务完成回调 URL（Webhook）
</ParamField>

<ParamField body="prompt" type="string" required>
  图像描述提示词，支持 Midjourney 原生参数（如 `--ar 16:9 --v 6.1`）
</ParamField>

<ParamField body="state" type="string">
  透传状态字段，原样携带到回调
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "base64Array": [],
  "botType": "MID_JOURNEY",
  "notifyHook": "",
  "prompt": "cat",
  "state": ""
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/imagine" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "base64Array": [],
  "botType": "MID_JOURNEY",
  "notifyHook": "",
  "prompt": "cat",
  "state": ""
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "Submit success",
  "properties": {
    "discordChannelId": "1300842676874379336",
    "discordInstanceId": "1572398367386955776"
  },
  "result": "1730621718151844"
}
```

***

## 提交Modal

`POST /mj/submit/modal`

针对图像的特定区域进行局部重绘（Vary Region / Inpaint），需提供遮罩区域。

### 请求参数 (Query / Path)

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="botType" type="string">
  机器人 / Bot 类型
</ParamField>

<ParamField body="maskBase64" type="string">
  遮罩图像 Base64（白色区域为重绘区域）
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址
</ParamField>

<ParamField body="prompt" type="string">
  局部重绘的新提示词（可为空，保留原提示词）
</ParamField>

<ParamField body="state" type="string">
  自定义透传状态
</ParamField>

<ParamField body="taskId" type="string" required>
  原任务 ID
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "maskBase64": "",
  "prompt": "",
  "taskId": "14001934816969359"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/modal" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "maskBase64": "",
  "prompt": "",
  "taskId": "14001934816969359"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}
```

***

## 提交 Shorten 任务

`POST /mj/submit/shorten`

分析提示词并返回精简版本，帮助优化冗长的 prompt。

### 请求体参数 (Body)

<ParamField body="botType" type="string">
  机器人 / Bot 类型
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址
</ParamField>

<ParamField body="prompt" type="string" required>
  需要精简的提示词
</ParamField>

<ParamField body="state" type="string">
  自定义透传状态
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "botType": "MID_JOURNEY",
  "prompt": "a very beautiful and majestic white horse with flowing mane running through an enchanted mystical forest with golden rays of sunlight filtering through the ancient tall trees"
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/shorten" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "botType": "MID_JOURNEY",
  "prompt": "a very beautiful and majestic white horse with flowing mane running through an enchanted mystical forest with golden rays of sunlight filtering through the ancient tall trees"
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": "1743326750223591"
}
```

***

## 文本指令变换（content）

`POST /mj/submit/simple-change`

### 请求体参数 (Body)

<ParamField body="content" type="string" required>
  变换指令文本，形如「任务ID 操作」，如 "1719999999999000 U1"
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址, 为空时使用全局notifyHook
</ParamField>

<ParamField body="state" type="string">
  自定义参数
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/simple-change" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "success",
  "result": "1720000000000000"
}
```

***

## 上传图片

`POST /mj/submit/upload-discord-images`

官方文档：[https://docs.midjourney.com/hc/en-us/articles/33329380893325-Managing-Image-Uploads](https://docs.midjourney.com/hc/en-us/articles/33329380893325-Managing-Image-Uploads)

### 请求参数 (Query / Path)

<ParamField header="content-type" type="string" required>
  请求体 Content-Type，一般为 application/json
</ParamField>

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="base64Array" type="array" required>
  输入图片 Base64 数组
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "base64Array": [
    "data:image/png;base64,iVBORw0KGgo..."
  ]
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/upload-discord-images" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "base64Array": [
    "data:image/png;base64,iVBORw0KGgo..."
  ]
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "success",
  "result": "1720000000000000"
}
```

***

## 图生视频（增强版功能）

`POST /mj/submit/video`

### 请求体参数 (Body)

<ParamField body="base64" type="string">
  原图 base64，前端与 image 传同一值。透传给上游
</ParamField>

<ParamField body="image" type="string" required>
  原图 base64（带前缀：data:image/png;base64,...），图生视频的底图。透传给上游，后端结构体未声明
</ParamField>

<ParamField body="mode" type="string">
  生成模式（透传给上游）。FAST(默认)/RELAX/TURBO
</ParamField>

<ParamField body="motion" type="string">
  运动强度（透传给上游）。low(默认)/high
</ParamField>

<ParamField body="notifyHook" type="string">
  回调地址, 为空时使用全局notifyHook
</ParamField>

<ParamField body="prompt" type="string" required>
  视频内容/运动描述
</ParamField>

<ParamField body="state" type="string">
  自定义参数
</ParamField>

<ParamField body="taskId" type="string">
  可选。若对【已有 MJ 任务】生成视频，传该任务 ID（走后端 relay-mj.go:690 分支，需要 taskId）；图生视频（传 image）则不需要
</ParamField>

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/submit/video" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 1,
  "description": "success",
  "result": "1720000000000000"
}
```

***

## 根据ID列表查询任务

`POST /mj/task/list-by-condition`

根据 ID 列表批量查询多个任务状态。

### 请求参数 (Query / Path)

<ParamField header="Authorization" type="string">
  Bearer API Key
</ParamField>

### 请求体参数 (Body)

<ParamField body="ids" type="array" required>
  ID 列表
</ParamField>

### 请求示例 (JSON)

```json theme={null}
{
  "ids": [
    "1743326750223591",
    "1743326750223592"
  ]
}
```

### 请求示例 (cURL)

```bash theme={null}
curl -X POST "https://socialvision.tisyk.xyz/mj/task/list-by-condition" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "1743326750223591",
    "1743326750223592"
  ]
}'
```

### 响应示例 (200 OK)

```json theme={null}
{
  "code": 0,
  "data": [
    {
      "action": "string",
      "buttons": [
        {
          "customId": "string",
          "emoji": "string",
          "label": "string",
          "style": 0,
          "type": 0
        }
      ],
      "description": "string",
      "failReason": "string",
      "finishTime": 0,
      "id": "string",
      "imageUrl": "string",
      "progress": "string",
      "prompt": "string",
      "promptEn": "string",
      "startTime": 0,
      "state": "string",
      "status": "NOT_START",
      "submitTime": 0
    }
  ]
}
```

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.