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

# 图像生成

> 根据文字描述自动生成图像，兼容 OpenAI Images API 格式。

在给定提示的情况下创建图像。[了解更多](https://platform.openai.com/docs/guides/images)。

## 请求头

**Authorization** `string` *required*

Bearer Token 认证，格式：`Bearer <token>`

## 请求体

格式：`application/json`

**model** `string`

用于图像生成的模型。`dall-e-2`、`dall-e-3` 或 `gpt-image-1` 之一。默认为 `dall-e-2`，除非使用特定于 `gpt-image-1` 的参数。

**prompt** `string` *required*

所需图像的文本描述。`gpt-image-1` 的最大长度为 32000 个字符，`dall-e-2` 的最大长度为 1000 个字符，`dall-e-3` 的最大长度为 4000 个字符。

**n** `integer`

要生成的图像数量。必须介于 1 到 10 之间。对于 `dall-e-3`，仅支持 `n=1`。

**size** `string`

生成的图像的大小。对于 `gpt-image-1`，必须是 `1024x1024`、`1536x1024`（横向）、`1024x1536`（纵向）或 `auto`（默认值）之一；对于 `dall-e-2`，必须是 `256x256`、`512x512` 或 `1024x1024` 之一；对于 `dall-e-3`，必须是 `1024x1024`、`1792x1024` 或 `1024x1792` 之一。

**background** `string`

允许为生成的图像的背景设置透明度。此参数仅支持 `gpt-image-1`。必须是以下之一：`transparent`（透明）、`opaque`（不透明）或 `auto`（默认值）。使用 `auto` 时，模型将自动确定图像的最佳背景。

如果是透明的，则输出格式需要支持透明度，因此应将其设置为 `png`（默认值）或 `webp`。

**moderation** `string`

控制 `gpt-image-1` 生成的图像的内容审核级别。必须为 `low`（限制较少的筛选）或 `auto`（默认值）。

**quality** `string`

将生成的图像的质量。

**stream** `string`

是否流式返回

**style** `string`

生成图像的风格

**user** `string`

代表最终用户的唯一标识符

## 响应

### 200

格式：`application/json`

**created** `integer` *required*

创建时间戳（Unix 时间）。

**data** `object[]` *required*

生成的图像列表。

**属性**

**b64\_json** `string`

Base64 编码的图像数据

**url** `string` *required*

图像 URL

**usage** `object` *required*

图像生成过程的 Token 用量统计。

**属性**

**total\_tokens** `integer` *required*

总 Token 数

**input\_tokens** `integer` *required*

输入 Token 数

**output\_tokens** `integer` *required*

输出 Token 数

**input\_tokens\_details** `object` *required*

输入 Token 细分

**属性**

**text\_tokens** `integer`

文本 Token 数

**image\_tokens** `integer`

图像 Token 数

```bash cURL theme={"dark"}
curl -X POST "https://t.ato2.nodesms.com/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cute baby sea otter wearing a beret",
    "n": 1,
    "size": "1024x1024"
  }'
```

```python Python theme={"dark"}
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxx",
    base_url="https://t.ato2.nodesms.com/v1"
)

response = client.images.generate(
    model="dall-e-3",
    prompt="A cute baby sea otter wearing a beret",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)
```

```json 200 theme={"dark"}
{
  "created": 1719123456,
  "data": [
    {
      "url": "https://example.com/image.png"
    }
  ],
  "usage": {
    "total_tokens": 500,
    "input_tokens": 300,
    "output_tokens": 200,
    "input_tokens_details": {
      "text_tokens": 300,
      "image_tokens": 0
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.