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

# GPT-Image模型介绍

> 查看 AIOAGI GPT-Image 系列模型的 API 调用入口。

AIOAGI 提供多类图像生成模型。本页只介绍 `GPT-Image` 系列的 OpenAI 兼容接口入口。你可以直接复用 OpenAI 风格的请求格式，并将基础地址设置为 `https://api.aiearth.dev/v1` 或 `https://api.aiearth.vip/v1`。

<Info>
  站内还提供 `banana` 等其他图像模型系列。模型名称、价格、输出格式和支持策略可能调整。请在 **控制台** 或 **开发者指南** 中确认当前可用模型，再上线生产调用。
</Info>

## 模型入口

<CardGroup cols={2}>
  <Card title="gpt-image-2" icon="image">
    使用 `/images/generations` 创建图像，或使用 `/images/edits` 编辑图像。
  </Card>

  <Card title="gpt-image-2-chat" icon="messages">
    使用 `/chat/completions` 传入图文消息，适合对话式图像生成与编辑。
  </Card>
</CardGroup>

## 接口概览

| 模型                 | 接口                    | 方法     | 说明                                                               |
| ------------------ | --------------------- | ------ | ---------------------------------------------------------------- |
| `gpt-image-2`      | `/images/generations` | `POST` | 根据提示词生成新图像，返回 `b64_json`。                                        |
| `gpt-image-2`      | `/images/edits`       | `POST` | 基于一张或多张输入图像生成编辑结果，返回 `b64_json`。                                 |
| `gpt-image-2-chat` | `/chat/completions`   | `POST` | 使用 Chat Completions 传入文本和图片上下文，支持 `metadata.size` 或 prompt 尺寸前缀。 |

## 调用建议

* 为图像任务单独创建 `Token 组`，这样更容易做额度控制和账单追踪。
* 在服务端记录请求 ID、模型名、耗时和错误信息，便于排查失败请求。
* 如果你需要透明背景，请同时确认 `background` 和 `output_format` 是否匹配。
* 在生产环境上线前，请先在 **控制台** 或 **开发者指南** 中核对当前支持的模型名称、价格和额度策略。