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

# Midjourney API 总览

> 调用流程、鉴权、全部接口、速度与版本、计费和错误码

用接口调用 Midjourney：生成图片，对图片继续加工，把图片做成视频。所有接口都是异步任务（识图除外）：提交后拿到任务 ID，再查询结果，或者提交时带上 `notify_hook` 等我们推送。

## 基础信息

| 项目 | 说明 |
| - | - |
| Base URL | `https://api.ephone.ai` |
| 鉴权 | 请求头 `Authorization: Bearer YOUR_API_KEY` |
| 请求体 | JSON，`Content-Type: application/json` |

每个接口页右侧都有调试面板：填入 API Key 和参数就能直接发请求。调试面板发出的是真实请求，会正常计费。

## 调用流程

**1. 提交任务**

调新建任务的接口，比如 [图像生成](https://docs.rixapi.com/docs/cn/api-reference/midjourney/imagine.md)，返回 `task_id`。

**2. 取回结果**

用 [查询结果](https://docs.rixapi.com/docs/cn/api-reference/midjourney/task.md) 每 3 到 5 秒查一次，直到 `status` 变成 `success` 或 `failure`。也可以提交时带上 `notify_hook`，任务结束后我们把和查询结果相同的内容推送过去。

**3. 接着加工**

结果里的 `actions` 列出还能接着做的加工，调 [图像操作](https://docs.rixapi.com/docs/cn/api-reference/midjourney/action.md)，`action` 填其中一个。新任务完成后也有自己的 `actions`，可以一直接下去。

## 全部接口

提交接口的路径是 `POST /midjourney/{名字}`（名字见下表第一列），查询是 `GET /midjourney/task/{task_id}`。

| 接口 | 能做什么 |
| - | - |
| [图像生成](https://docs.rixapi.com/docs/cn/api-reference/midjourney/imagine.md) `imagine` | 用提示词生成四张图，可以垫图 |
| [图片混合](https://docs.rixapi.com/docs/cn/api-reference/midjourney/blend.md) `blend` | 把 2 到 5 张图融合成新图 |
| [图像描述](https://docs.rixapi.com/docs/cn/api-reference/midjourney/describe.md) `describe` | 识图：给出描述这张图的提示词，同步返回 |
| [指令编辑](https://docs.rixapi.com/docs/cn/api-reference/midjourney/edit.md) `edit` | 按文字指令修改一张图，只支持 V8.1 及以后 |
| [风格转绘](https://docs.rixapi.com/docs/cn/api-reference/midjourney/retexture.md) `retexture` | 保留构图，按提示词换风格与材质，支持 V7 与 V6 系列 |
| [图生视频](https://docs.rixapi.com/docs/cn/api-reference/midjourney/video.md) `video` | 用你自己的图做首帧，生成约 5 秒的视频 |
| [图像操作](https://docs.rixapi.com/docs/cn/api-reference/midjourney/action.md) `action` | 加工已有任务：放大、变化、重塑、重跑、扩图、平移、局部重绘、增强、做视频、延长视频 |
| [查询结果](https://docs.rixapi.com/docs/cn/api-reference/midjourney/task.md) `task/{task_id}` | GET，查询任务状态与产物 |

> [!TIP]
>
> 也可以用统一任务接口 `POST /v1/task/submit` 提交：`model` 填 `midjourney-` 加动作名（如 `midjourney-imagine`、`midjourney-upscale`），参数放进 `input`，不用传 `action`。两种方式的任务 ID 通用，计费完全一样。

## 速度与版本

* **速度**：参数 `speed` 取 `relax`（慢速，快速价的 0.4 倍）、`fast`（默认）或 `turbo`（极速，快速价的 2 倍）。识图不分速度，视频没有慢速。
* **版本**：在提示词末尾写 `--v 7`、`--niji 7` 这样的参数选版本，不写时用 V8.2（Midjourney 现在的默认版本）。加工沿用原图的版本。
* **提示词**：可以照常写 Midjourney 参数，最长 6000 个字符；V8 系列正文在 1024 个字符以内一定能用，更长的可能被拒。各版本的写法与限制见 [能力与参数](https://docs.rixapi.com/docs/cn/guides/midjourney-workflows.md)。

## 计费

按次计费，失败自动退费。每个能力按速度分档的单价见对应模型详情页的价格表；草图、高清、视频分辨率与条数等倍率见 [能力与参数](https://docs.rixapi.com/docs/cn/guides/midjourney-workflows.md)。

## 错误

错误响应统一是这个形状，HTTP 状态码与错误类型对应：

```json theme={null}
{ "error": { "code": "invalid_request", "message": "index must be between 1 and 4" } }
```

\| HTTP | `code` | 含义 |
\| --- | --- |
\| 400 | `invalid_request` | 参数不对，`message` 会说明是哪一个 |
\| 400 | `unsupported_action` | 这个任务不能做这个操作，以查询结果里的 `actions` 为准 |
\| 400 | `content_rejected` | 提示词或图片没通过内容审核，未扣费 |
\| 401 | `unauthorized` | API Key 缺失或无效 |
\| 402 / 403 | `insufficient_quota` | 余额不足 |
\| 404 | `task_not_found` | 任务不存在，或不属于当前账号 |
\| 404 | `not_found` | 接口名写错了 |
\| 409 | `task_not_finished` | 要加工的任务还没成功 |
\| 429 | `rate_limited` / `queue_full` | 请求太频繁，或生成队列已满，稍后重试 |
\| 5xx | `upstream_error` / `internal_error` | 服务端故障，可以重试 |

## 下一步

> [card] [Midjourney 快速上手](https://docs.rixapi.com/docs/cn/guides/midjourney-quickstart.md)
>
> 生成第一组图，取回结果，再接着加工

> [card] [Midjourney 能力与参数](https://docs.rixapi.com/docs/cn/guides/midjourney-workflows.md)
>
> 提示词参数、后续操作规则、计费细节


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