Skip to main content
POST
/
v1
/
images
/
generations
图像
curl --request POST \
  --url https://api.deerapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-1.5",
  "prompt": "A cute baby sea otter"
}
'
{
  "created": 123,
  "data": [
    {
      "b64_json": "<string>"
    }
  ],
  "usage": [
    "<string>"
  ]
}

​
概述

images/generations 是 OpenAI 的图像生成接口,通过文本提示词创建高质量的图像内容。 参数列表细节或更多用法建议参考 OpenAI 官方文档

​
核心特性

  • 文本到图像生成:根据自然语言描述生成图像
  • 多种尺寸支持:支持不同分辨率的图像输出
  • 灵活的输出格式:支持 base64 编码或 URL 格式
  • 批量生成:一次请求可生成多张图像
  • 风格控制:通过提示词精确控制图像风格和细节

​
重要说明与常见问题

⚠️ 内容政策
生成的图像内容必须遵守 OpenAI 的使用政策,不得生成违规、暴力、色情或侵犯版权的内容。 ⚠️ 返回格式
使用 dall-e-2 和 dall-e-3 生成的图像返回格式必须为 url 或 b64_json。URLs 仅在图像生成后有效 60 分钟。此参数不支持 gpt-image-1，后者将始终返回 base64 编码的图像。 注意 “qwen-image” 模型时不需要传参数 “n”，仅能输出一张

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

application/json
​
model
string
default:dall-e-3
required

图像生成使用的模型。支持 dall-e-2、dall-e-3、GPT 图像模型（gpt-image-1、gpt-image-1-mini、gpt-image-1.5）以及其他图像模型（如 qwen-image）。查看 DeerAPI 支持的完整模型列表。

​
prompt
string
default:A cute baby sea otter
required

描述所需图像的文字提示词。不同模型的最大长度限制：

  • dall-e-2：最多 1000 个字符
  • dall-e-3：最多 4000 个字符
  • gpt-image-1 系列：支持较长的描述

提示词越详细，生成的图像质量越高。

​
n
integer

生成的图像数量。dall-e-2 支持 1–10 张；dall-e-3 和 gpt-image-1 系列目前仅支持 1 张。

​
size
string

生成图像的尺寸，不同模型支持的尺寸如下：

  • dall-e-2：256x256、512x512、1024x1024
  • dall-e-3：1024x1024、1792x1024（宽屏）、1024x1792（竖屏）
  • gpt-image-1 系列：1024x1024、1536x1024、1024x1536、auto
​
quality
string

图像生成的质量等级。

  • dall-e-3：支持 standard（默认）和 hd（更情达的细节）
  • gpt-image-1 系列：支持 low、medium、high（默认 auto）
​
style
enum<string>

图像风格（仅 dall-e-3 支持）。vivid（鲜艳超现实风格，默认）或 natural（自然、写实风格）。

Available options:
vivid,
natural
​
response_format
enum<string>

响应中图像的返回格式。url（返回可访问的图片 URL，60 分钟内有效）或 b64_json（返回 base64 编码的图片数据）。gpt-image-1 系列仅支持 b64_json。默认为 url。

Available options:
url,
b64_json

Response

200 - application/json

Successful Response

​
created
integer
required

图像生成任务完成时的Unix时间戳

​
data
object[]
required

一个包含所生成图像信息的列表。

​
usage
string[]
required