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

# Midjourney API

> 通过 APIMart 渠道调用 Midjourney 的统一异步 API

<Note>
  Midjourney 使用本系统的统一异步任务 ID. 请求需要 `Authorization: Bearer YOUR_API_KEY`. 中国大陆用户请将 Base URL 替换为 `https://toapis.cn`.
</Note>

Midjourney 支持以下操作:

`imagine`, `blend`, `describe`, `edits`, `upscale`, `variation`, `high-variation`, `low-variation`, `reroll`, `zoom`, `pan`, `inpaint`, `modal`, `video`, `remix-strong`, `remix-subtle`.

所有提交接口返回任务 ID, 使用 [查询接口](./query) 获取结果. 上游 APIMart 的 task ID 不需要由客户端传入或保存.

## 接口

| 操作 | 方法和路径 |
| - | - |
| 默认生成 | `POST /v1/midjourney/generations` |
| 指定操作 | `POST /v1/midjourney/generations/{action}` |
| 查询任务 | `GET /v1/midjourney/{task_id}` |

默认路径等同于 `imagine`.

## 通用请求字段

<ParamField body="model" type="string" required>
  固定为 `midjourney`.
</ParamField>

<ParamField body="prompt" type="string">
  文本提示词.`imagine` 和 `edits` 必填, `modal` 可选并默认继承父任务提示词.
</ParamField>

<ParamField body="image_urls" type="string[]">
  公开可访问的图片 URL. 请先使用[上传图片接口](../../uploads/images), 不要直接提交 base64. 每张图片不超过 12 MiB.
</ParamField>

<ParamField body="task_id" type="string">
  父任务 ID. 用于图片操作、视频和 Remix. 必须属于当前 API Key 对应用户.
</ParamField>

<ParamField body="speed" type="string" default="relax">
  `relax`, `fast` 或 `turbo`.
</ParamField>

<ParamField body="version" type="string">
  Midjourney 版本, 例如 `v8.2`, `v8.1`, `v7`, `v6.1`.
</ParamField>

## 提交示例

```bash cURL theme={null}
curl --request POST \
  --url https://toapis.com/v1/midjourney/generations/imagine \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "midjourney",
    "prompt": "a cinematic lighthouse above a stormy sea",
    "speed": "fast",
    "version": "v8.2"
  }'
```

```json Response theme={null}
{
  "id": "tsk_img_xxx",
  "object": "generation.task",
  "model": "midjourney",
  "status": "queued",
  "progress": 0,
  "created_at": 1710000000
}
```

<Warning>
  APIMart 没有取消接口. 本系统不会虚构取消接口. 失败任务按照统一任务规则处理退款和 webhook.
</Warning>


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