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

# AIReiter — AI 文本、图像与视频生成 API 平台

> 统一的 AI 文本、图像和视频生成 API 平台。支持多种主流模型，包括 Claude、GPT、Gemini、Sora2、VEO3、Seedance2 等。兼容 OpenAI SDK，异步任务处理，透明定价，简单易用。

export const apiKeyUrl = 'https://aireiter.com/keys';

AIReiter 是一个统一的 AI 内容生成 API 平台，提供文本对话、图像生成和视频生成服务。通过简单的 REST API 调用，即可使用 Claude、GPT、Gemini、Sora2、VEO3、Seedance2 等多种主流 AI 模型。文本接口完全兼容 OpenAI SDK，可直接替换 `baseURL` 使用。

## 快速开始

<CardGroup cols={2}>
  <Card title="文本对话" icon="message" href="/zh/api-reference/text/openai-chat-completions-api/endpoint">
    兼容 OpenAI SDK，支持 Claude、GPT 等模型
  </Card>

  <Card title="图像生成" icon="image" href="/zh/api-reference/images/gpt-4o/generation">
    使用 GPT-4o、Gemini、Seedream 等模型生成图像
  </Card>

  <Card title="视频生成" icon="video" href="/zh/api-reference/videos/sora2/generation">
    使用 Sora2、VEO3、Seedance2 等模型生成视频内容
  </Card>

  <Card title="任务状态查询" icon="list-check" href="/zh/api-reference/tasks/status">
    查询异步任务的执行状态和结果
  </Card>

  <Card title="查询余额" icon="wallet" href="/zh/api-reference/tasks/balance">
    查询积分余额及各模型免费额度剩余次数
  </Card>

  <Card title="获取 API Key" icon="key" href={apiKeyUrl}>
    访问控制台获取您的 API Key
  </Card>
</CardGroup>

## API 工作流程

### 1. 提交生成任务

所有图像和视频生成都采用异步处理模式。提交任务时需要传入 `out_task_id`（发起方任务ID），系统会返回 `out_task_id`：

```bash theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_4o",
    "params": {
      "prompt": "一只可爱的猫咪在花园里",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'
```

### 2. 查询任务状态

使用您提交时的 `out_task_id` 查询任务进度和结果：

```bash theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "out_task_id": "my_task_123456"
  }'
```

### 3. 获取生成结果

任务完成后，响应中会包含生成的图像或视频 URL：

```json theme={null}
{
  "statusCode": 200,
  "message": "",
  "data": {
    "out_task_id": "my_task_123456",
    "status": "completed",
    "output": [
      {
        "url": "https://s1.pxz.ai/upload/image-generator/xxx.jpeg"
      }
    ]
  }
}
```

## 模型通道

模型通道代表不同的服务等级。每个模型可提供多种通道版本，分为四个等级：

| 通道         | 说明        |
| ---------- | --------- |
| `base`     | 基础版，价格最低  |
| `plus`     | 增强版       |
| `advanced` | 高级版       |
| `max`      | 旗舰版，稳定性最高 |

<Note>
  通道只影响服务稳定性，不影响输出质量。所有通道使用相同的底层模型，生成结果的质量完全一致。通常来说，价格越高的通道，服务稳定性越好。
</Note>

使用时只需将模型名称替换为对应的通道版本即可，例如将 `"sora2"` 替换为 `"sora2_plus"`，其他参数保持不变。

## 支持的模型

### 文本对话系列

兼容 OpenAI Chat Completions API 和 Responses API，支持多轮对话、工具调用、结构化输出、流式响应：

<CardGroup cols={2}>
  <Card title="OpenAI Chat Completions API" icon="message" href="/zh/api-reference/text/openai-chat-completions-api/endpoint">
    兼容 OpenAI SDK，支持 GPT、Claude 等模型
  </Card>

  <Card title="OpenAI Responses API" icon="message" href="/zh/api-reference/text/openai-responses-api/endpoint">
    OpenAI 最新 Responses 格式
  </Card>

  <Card title="Claude Messages API" icon="message" href="/zh/api-reference/text/claude-messages-api/endpoint">
    Anthropic 原生 Messages API 格式
  </Card>
</CardGroup>

### 图像生成系列

AIReiter 提供多种图像生成模型，支持文本生成图像和图生图功能：

<CardGroup cols={2}>
  <Card title="GPT-4o Image" icon="image" href="/zh/api-reference/images/gpt-4o/generation">
    OpenAI 的高质量图像生成模型
  </Card>

  <Card title="GPT-Image-2" icon="image" href="/zh/api-reference/images/gpt-image-2/generation">
    支持文生图 / 图生图，13 种比例，参考图最多 9 张
  </Card>

  <Card title="Gemini-2.5-Flash (Nano banana)" icon="image" href="/zh/api-reference/images/nano-banana/generation">
    Google 最新的快速图像生成模型
  </Card>

  <Card title="Gemini-3-Pro (Nano banana pro)" icon="image" href="/zh/api-reference/images/gemini-3-pro/generation">
    Google 专业级图像生成模型
  </Card>

  <Card title="Nano Banana V2" icon="image" href="/zh/api-reference/images/nano-banana-v2/generation">
    支持文本转图片、图生图、图像编辑等多种生成模式
  </Card>

  <Card title="Seedream-4.0" icon="image" href="/zh/api-reference/images/seedream-4/generation">
    高效的图像生成解决方案
  </Card>

  <Card title="Seedream-4.5" icon="image" href="/zh/api-reference/images/seedream-4.5/generation">
    Seedream 4.5 版本
  </Card>

  <Card title="Seedream V5 lite" icon="image" href="/zh/api-reference/images/seedream-v5-lite/generation">
    Seedream 最新版本，支持联网搜索增强生成
  </Card>
</CardGroup>

### 视频生成系列

支持文本生成视频和图生视频，提供多种分辨率和时长选项：

<CardGroup cols={2}>
  <Card title="Sora2" icon="video" href="/zh/api-reference/videos/sora2/generation">
    OpenAI Sora2 视频生成模型（10-15秒）
  </Card>

  <Card title="Sora2 Pro" icon="video" href="/zh/api-reference/videos/sora2-pro/generation">
    Sora2 专业版，支持高清分辨率
  </Card>

  <Card title="VEO3.1" icon="video" href="/zh/api-reference/videos/veo3-1/generation">
    Google VEO3.1 视频生成模型
  </Card>

  <Card title="VEO3.1 Fast" icon="video" href="/zh/api-reference/videos/veo3-1-fast/generation">
    VEO3.1 快速版本
  </Card>

  <Card title="Seedance-1.5-pro" icon="video" href="/zh/api-reference/videos/seedance-1-5-pro/generation">
    支持首尾帧控制和音频生成（4-12秒）
  </Card>

  <Card title="Seedance Pro Fast" icon="video" href="/zh/api-reference/videos/seedance_pro_fast/generation">
    Seedance 快速版本，支持首帧控制
  </Card>

  <Card title="Seedance Pro" icon="video" href="/zh/api-reference/videos/seedance_pro/generation">
    Seedance 专业版，支持首尾帧控制
  </Card>

  <Card title="Seedance 2.0" icon="video" href="/zh/api-reference/videos/seedance2/generation">
    支持多参考图、参考视频和首尾帧控制（4-15秒）
  </Card>

  <Card title="Seedance 2.0 Fast" icon="video" href="/zh/api-reference/videos/seedance2_fast/generation">
    Seedance 2.0 快速版本，支持多参考图和首尾帧控制
  </Card>
</CardGroup>

## 核心功能

### 异步任务处理

所有生成请求采用异步处理模式，避免长时间等待：

* 提交任务时需传入 `out_task_id`（发起方任务ID，用于业务标识）
* 立即返回您提交的 `out_task_id`
* 可使用 `out_task_id` 查询任务状态
* 支持 webhook 回调通知（可选）
* 任务状态实时更新：`pending` → `processing` → `completed`

### 多模型支持

一个统一的 API 端点，支持多种文本、图像和视频生成模型：

* **文本对话**：Claude、GPT 等模型，兼容 OpenAI SDK
* **图像生成**：GPT-4o、Gemini、Seedream 等模型
* **视频生成**：Sora2、VEO3、Seedance 等模型
* 统一的请求格式和响应结构
* 灵活的参数配置

### 透明定价

按积分计费，透明清晰：

* 每个任务返回预估消耗积分
* 任务完成后显示实际消耗积分
* 只为成功生成的内容付费
* 无隐藏费用

### 灵活配置

支持多种生成参数配置：

* **图像**：多种宽高比（1:1、3:2、2:3）
* **视频**：多种宽高比（16:9、9:16）、时长（10秒、15秒）、分辨率
* 支持参考图像（图生图、图生视频）

## 认证方式

所有 API 请求都需要使用 Bearer Token 进行认证：

```
Authorization: Bearer YOUR_API_KEY
```

**获取 API Key：**

访问 <a href={apiKeyUrl} target="_blank">API Key 管理页面</a> 获取您的 API Key。

## 常见问题

<AccordionGroup>
  <Accordion title="如何获取 API Key？">
    访问 <a href={apiKeyUrl} target="_blank">API Key 管理页面</a>，登录后即可创建和管理您的 API Key。
  </Accordion>

  <Accordion title="图像和视频生成需要多长时间？">
    所有生成任务都是异步处理的。图像生成通常需要几秒到几十秒，视频生成根据时长和分辨率，通常需要 1-5 分钟。提交任务后会立即返回 out\_task\_id，您可以通过状态查询 API 跟踪进度。
  </Accordion>

  <Accordion title="如何查询任务状态？">
    使用任务状态查询 API，传入您自己设置的 `out_task_id`：

    ```bash theme={null}
    POST https://aireiter.com/api/openapi/query
    ```

    查看 [任务状态查询文档](/zh/api-reference/tasks/status) 了解详情。
  </Accordion>

  <Accordion title="什么是 out_task_id？">
    `out_task_id` 是发起方任务ID，由您在提交任务时自定义设置：

    * **必填参数**：提交任务时必须传入 `out_task_id`
    * **业务标识**：可以使用您系统中的订单号、业务ID等作为标识
    * **查询灵活**：可以直接使用 `out_task_id` 查询任务状态
    * **结果关联**：在查询结果中会返回 `out_task_id`，方便您关联业务数据
  </Accordion>

  <Accordion title="如何计费？">
    AIReiter 采用积分制计费：

    * 提交任务时返回预估消耗积分（`estimated_credits`）
    * 任务完成后返回实际消耗积分（`credits_used`）
    * 只为成功生成的内容付费，失败任务不收费
    * 不同模型的积分消耗不同
  </Accordion>

  <Accordion title="支持哪些图像格式和视频格式？">
    * **图像**：支持 JPEG、PNG 等常见格式
    * **视频**：输出 MP4 格式
    * **参考图像**：输入支持公开可访问的图像 URL
  </Accordion>
</AccordionGroup>

## 下一步

<CardGroup cols={2}>
  <Card title="查看文本对话文档" icon="message" href="/zh/api-reference/text/openai-chat-completions-api/endpoint">
    了解如何使用文本对话 API
  </Card>

  <Card title="查看图像生成文档" icon="image" href="/zh/api-reference/images/gpt-4o/generation">
    了解如何使用各种图像生成模型
  </Card>

  <Card title="查看视频生成文档" icon="video" href="/zh/api-reference/videos/sora2/generation">
    了解如何生成视频内容
  </Card>

  <Card title="任务管理" icon="list-check" href="/zh/api-reference/tasks/status">
    学习如何管理和查询任务状态
  </Card>

  <Card title="获取 API Key" icon="key" href={apiKeyUrl}>
    立即开始使用 AIReiter
  </Card>
</CardGroup>