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

# 图像系列概览

> 汇总图像生成、图像编辑、异步任务、素材上传，以及 OpenAI OG 与 Gemini GG 图像任务接入能力。

# 图像系列

图像能力按接口和模型系列组织。每个模型页都会说明请求路径、模型名、参考图输入、尺寸约束和返回结构，开发者可以直接进入目标模型页。

<CardGroup cols={2}>
  <Card title="模型支持矩阵" icon="table-cells" href="/api-reference/images/model-matrix">
    按模型家族查看图像接口支持范围、参考图输入方式、比例和尺寸约束。
  </Card>

  <Card title="Gemini 图像生成" icon="image" href="/api-reference/images/gemini-image/generation">
    `POST /v1beta/models/{model}:generateContent`，覆盖 Gemini 原生图像生成入口。
  </Card>

  <Card title="gpt-image-2" icon="image-plus" href="/api-reference/images/gpt-image-2/generation">
    `POST /v1/images/generations`，使用 `gpt-image-2` 生成图像。
  </Card>

  <Card title="gpt-image-2-pro" icon="sparkles" href="/api-reference/images/gpt-image-2-pro/generation">
    `POST /v1/images/generations`，使用 `gpt-image-2-pro` 生成高分辨率图像。
  </Card>

  <Card title="gpt-image-2-vip" icon="sparkles" href="/api-reference/images/gpt-image-2-vip/generation">
    `POST /v1/images/generations`，使用 `gpt-image-2-vip` 的 `1K`、`2K`、`4K` 尺寸表。
  </Card>

  <Card title="图像异步生成" icon="hourglass" href="/api-reference/images/gpt-image-async/generation">
    `POST /v1/images/generations/async`，用于耗时较长的图像生成任务。
  </Card>

  <Card title="OpenAI 系列（OG）" icon="image" href="/api-reference/images/openai-og/overview">
    `POST /v1/videos` 与 `GET /v1/videos/{task_id}`，用于 `image2` / OG 图像任务。
  </Card>

  <Card title="Gemini 系列（GG）" icon="image" href="/api-reference/images/gemini-gg/overview">
    `POST /v1/videos` 与 `GET /v1/videos/{task_id}`，用于 `GG` 图像任务。
  </Card>

  <Card title="Doubao Seedream" icon="image-upscale" href="/api-reference/images/doubao-seedream/generation">
    `POST /v1/images/generations`，支持 Seedream 文生图与图生图。
  </Card>

  <Card title="OpenAI Images 兼容" icon="wand-sparkles" href="/api-reference/images/gpt-image-1/overview">
    基于 `POST /v1/images/generations`、`POST /v1/images/edits`、`POST /v1/edits` 的兼容入口说明。
  </Card>

  <Card title="Midjourney" icon="wand-sparkles" href="/api-reference/images/midjourney/overview">
    `/mj/submit/*`、`/mj/task/*`、`/mj/image/{id}`，适合 imagine、blend、describe、upscale 和变体操作。
  </Card>

  <Card title="上传与结果查询" icon="upload" href="/api-reference/uploads/image-upload">
    先用 `/api/upload/presign` 上传素材，再把公网 URL 传入图像或视频接口。
  </Card>
</CardGroup>

## 路由清单

| Method | Path                                     | 说明                           |
| ------ | ---------------------------------------- | ---------------------------- |
| `POST` | `/v1/images/generations`                 | 图像生成入口                       |
| `POST` | `/v1/images/generations/async`           | 图像异步生成入口                     |
| `GET`  | `/v1/images/generations/async/{taskId}`  | 图像异步任务查询                     |
| `POST` | `/v1/videos`                             | OpenAI OG / Gemini GG 图像任务提交 |
| `GET`  | `/v1/videos/{task_id}`                   | OpenAI OG / Gemini GG 图像任务查询 |
| `POST` | `/v1/images/edits`                       | OpenAI Images 兼容编辑入口         |
| `POST` | `/v1/edits`                              | 旧版编辑别名                       |
| `POST` | `/v1/images/variations`                  | 路由已保留，当前未实现                  |
| `POST` | `/mj/submit/imagine`                     | Midjourney imagine           |
| `POST` | `/mj/submit/blend`                       | Midjourney blend             |
| `POST` | `/mj/submit/describe`                    | Midjourney describe          |
| `POST` | `/mj/submit/edits`                       | Midjourney 编辑相关动作            |
| `POST` | `/mj/submit/video`                       | Midjourney 视频相关动作            |
| `GET`  | `/mj/task/{id}/fetch`                    | Midjourney 任务查询              |
| `GET`  | `/mj/image/{id}`                         | Midjourney 图片代理              |
| `POST` | `/v1beta/models/{model}:generateContent` | Gemini 官方格式生图入口              |

<Warning>
  `/v1/images/variations`、`/v1/files*` 和 `fine-tunes*` 这类 OpenAI 兼容路径虽然在路由中占位，但当前会返回未实现错误，不能直接用于生产。
</Warning>

## 推荐阅读

1. [图像模型支持矩阵](/api-reference/images/model-matrix)
2. [OpenAI 系列（OG）图像任务概览](/api-reference/images/openai-og/overview)
3. [OpenAI 系列（OG）图像生成提交](/api-reference/images/openai-og/generation)
4. [OpenAI 系列（OG）图像任务查询](/api-reference/images/openai-og/query)
5. [Gemini 系列（GG）图像任务概览](/api-reference/images/gemini-gg/overview)
6. [Gemini 系列（GG）图像生成提交](/api-reference/images/gemini-gg/generation)
7. [Gemini 系列（GG）图像任务查询](/api-reference/images/gemini-gg/query)
8. [Gemini 图像生成 API](/api-reference/images/gemini-image/generation)
9. [图像异步生成 API](/api-reference/images/gpt-image-async/generation)
10. [Doubao Seedream 生成图像 API](/api-reference/images/doubao-seedream/generation)
11. [OpenAI Images 兼容概览](/api-reference/images/gpt-image-1/overview)