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

# Sub2API 支持的图像生成模型说明

> 了解可通过 Sub2API 访问的图片生成模型，包括 DALL-E 系列的特性与调用方式。

Sub2API 提供图像生成模型的访问能力，支持通过 OpenAI 兼容的 API 格式创建图片。你可以使用自然语言描述来生成高质量图像，适用于内容创作、设计和原型开发等场景。

## 支持的模型

Sub2API 支持主流的图像生成模型，目前主要包括 DALL-E 系列。不同模型在图像质量、生成速度和功能特性上有所差异。

## 模型一览

| 模型名称                  | 适用场景    | 功能特性      | 备注     |
| --------------------- | ------- | --------- | ------ |
| TODO: 请在控制台查看最新可用模型列表 | 高质量图像生成 | 支持多种尺寸和风格 | 图像最精细  |
| TODO: 请在控制台查看最新可用模型列表 | 快速图像生成  | 基础功能      | 生成速度更快 |

## 图像生成参数

调用图像生成模型时，你可配置以下参数：

| 参数        | 说明           | 可选值                 |
| --------- | ------------ | ------------------- |
| `prompt`  | 描述要生成图像内容的文本 | 任意文本描述              |
| `size`    | 生成图像的尺寸      | TODO：请在后台确认实际配置后填写。 |
| `quality` | 图像质量等级       | TODO：请在后台确认实际配置后填写。 |
| `style`   | 图像风格         | TODO：请在后台确认实际配置后填写。 |
| `n`       | 生成图像的数量      | 1 或更多               |

## API 调用示例

<CodeGroup>
  ```bash curl theme={null}
  curl https://sub2api.ruilinlu.com/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
      "model": "dall-e-3",
      "prompt": "一只穿着宇航服的猫在月球上行走，卡通风格",
      "size": "1024x1024",
      "quality": "standard",
      "n": 1
    }'
  ```

  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      base_url="https://sub2api.ruilinlu.com/v1",
      api_key="YOUR_API_KEY"
  )

  response = client.images.generate(
      model="dall-e-3",
      prompt="一只穿着宇航服的猫在月球上行走，卡通风格",
      size="1024x1024",
      quality="standard",
      n=1
  )

  print(response.data[0].url)
  ```
</CodeGroup>

## 响应格式

图像生成 API 返回的响应包含生成图像的 URL：

```json theme={null}
{
  "created": 1704067200,
  "data": [
    {
      "url": "https://generated-images.example.com/image_123.png",
      "revised_prompt": "A cat wearing a spacesuit walking on the moon, cartoon style"
    }
  ]
}
```

<Note>
  生成的图像 URL 通常有有效期限制。如果你需要长期保存，请下载图像并在自己的存储系统中保存。
</Note>

## 详细的 API 参考

关于图像生成 API 的完整参数说明和高级用法，请参考 [图像生成 API 文档](/api/image-generation)。

## 使用建议

* 使用详细、具体的 `prompt` 可以获得更高质量的生成结果
* 图像生成按次计费，建议在批量使用时做好成本控制
* 目前图像模型主要支持英文提示词，且中文理解能力也在不断提升