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

# Introduction

# OpenAI 简介

欢迎使用 **OpenAI** 服务文档！

Mountsea 的 OpenAI 服务提供 **GPT Image** 图像生成与编辑能力，包含两种接口风格：

<CardGroup cols={2}>
  <Card title="异步任务接口" icon="bolt" href="/zh/api-reference/openai/images-introduction">
    统一端点 `/openai/images`，一个接口同时支持文生图和图像编辑，异步返回 `taskId`，通过 `/openai/tasks` 轮询结果。
  </Card>

  <Card title="OpenAI 兼容接口" icon="plug" href="/zh/api-reference/openai/compat-introduction">
    OpenAI 官方 Images API 的直接替代。配合官方 `openai` SDK 使用 —— 只需将 `base_url` 改为 `https://api.mountsea.ai/openai/v1`。
  </Card>
</CardGroup>

## 支持的模型

| 模型            | 说明                                           |
| ------------- | -------------------------------------------- |
| `gpt-image-2` | OpenAI 最新图像模型 —— 支持文生图、编辑、局部重绘（mask），以及高保真输入 |

## 服务概览

### ⚡ 异步任务接口 (`/openai/images`)

统一的接口，根据请求体中是否包含 `image` 字段自动判断操作类型：

* **不传 `image`** → 文生图（对应 `/v1/images/generations`）
* **传 `image`** → 图像编辑（对应 `/v1/images/edits`），支持 URL 或 base64 data URL
* **传 `image` + `mask`** → 局部重绘（mask 中透明区域将被重绘）

立即返回 `taskId`，通过 `GET /openai/tasks?taskId=...` 轮询直至任务达到终态。

[浏览异步接口文档 →](/zh/api-reference/openai/images-introduction)

***

### 🔌 OpenAI 兼容接口（官方 SDK）

**完全兼容** OpenAI 官方 Images API：

* **文生图** —— `POST /openai/v1/images/generations`（与 `https://api.openai.com/v1/images/generations` 完全一致）
* **图像编辑** —— `POST /openai/v1/images/edits`（multipart/form-data，与 OpenAI 完全一致）
* **同步返回** —— 响应中直接返回生成的图像（无需轮询）
* **官方 SDK 支持** —— 可直接使用 Python / Node.js 的 `openai` SDK，仅需覆盖 `base_url`

[浏览兼容接口文档 →](/zh/api-reference/openai/compat-introduction)

***

## 如何选择？

| 使用场景                               | 推荐接口     |
| ---------------------------------- | -------- |
| 已有代码使用 `openai` SDK，希望无缝切换提供商      | **兼容接口** |
| 希望使用统一的异步接口，保持与 Mountsea 其他服务一致的行为 | **异步接口** |
| 需要后台批量处理并通过 ID 追踪                  | **异步接口** |
| 希望单次 HTTP 请求同步返回图像                 | **兼容接口** |

## Base URL

```
https://api.mountsea.ai
```

使用兼容 SDK 接口时，将 OpenAI SDK 的 `base_url` 设置为：

```
https://api.mountsea.ai/openai/v1
```

## 鉴权

所有端点均需要 Bearer Token 鉴权：

```
Authorization: Bearer your-api-key
```