DALL·E 3 图片生成 API 参考

以 dall-e-3（DALL·E 3）为例，演示文生图、图像编辑与变体的完整调用方式。

字段	值
Base URL	`https://ai-api.easyapi.com/v1`
认证	`Authorization: Bearer <API_KEY>`
示例模型	`dall-e-3`
格式	OpenAI Images 兼容
计费	按量计费

注意： DALL·E 3 为同步接口，提交后直接在响应中返回图片 URL 或 base64；Midjourney 等异步绘图模型请使用控制台「绘图日志」查看任务结果。

示例模型

下文均以 dall-e-3 （DALL·E 3）为例；更换其他模型时，请替换 model 参数，并参考控制台模型说明调整 size、quality 等字段。

提交文生图

POSThttps://ai-api.easyapi.com/v1/images/generations

使用 DALL·E 3 根据文本描述生成图片，成功返回 200 及图片 URL（或 base64 数据）。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer <API_KEY>
`Content-Type`	header	string	是	请求体格式，固定 application/json

请求体

名称	类型	必选	说明
`model`	string	否	图像模型：dall-e-2、dall-e-3 或 gpt-image-1；未指定时默认 dall-e-2
`prompt`	string	是	图像描述。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
`moderation`	string	否	内容审核级别，仅 gpt-image-1：low 或 auto
`quality`	string	否	图像质量，取值因模型而异
`stream`	boolean	否	是否流式返回（部分模型支持）
`style`	string	否	图像风格，如 vivid 或 natural
`user`	string	否	终端用户唯一标识，便于滥用检测与审计

示例

{
  "model": "dall-e-3",
  "prompt": "一只金毛犬在阳光明媚的海滩上奔跑，水彩插画风格，柔和光线",
  "n": 1,
  "size": "1024x1024",
  "quality": "hd",
  "style": "vivid"
}

响应示例

{
  "created": 1718452800,
  "data": [
    {
      "url": "https://cdn.example.com/images/img_dalle3_7c2f9a1b.png",
      "revised_prompt": "A golden retriever running on a sunny beach, watercolor illustration style"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    }
  }
}

图像编辑

POSThttps://ai-api.easyapi.com/v1/images/edits

在参考图基础上按 prompt 局部重绘或扩展，需使用 multipart/form-data 上传图片文件；model 示例仍为 dall-e-3。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer <API_KEY>
`Content-Type`	header	string	是	multipart/form-data

请求体

名称	类型	必选	说明
`image`	file	是	PNG 参考图，小于 4MB，方形画布效果最佳
`prompt`	string	是	希望生成或修改的内容描述
`model`	string	否	模型 ID，示例 dall-e-3
`n`	integer	否	生成张数，默认 1
`size`	string	否	输出尺寸，需与模型支持范围一致

示例

# multipart/form-data 表单字段示例
image=@reference.png
prompt=将背景替换为星空夜景，保持狗狗主体不变
model=dall-e-3
size=1024x1024

响应： HTTP 200，响应结构与文生图相同，data 数组包含 url 或 b64_json。

图像变体

POSThttps://ai-api.easyapi.com/v1/images/variations

基于已有图片生成风格相近的变体，上传参考图即可；适用于 DALL·E 3 等 OpenAI Images 模型。

请求参数

名称	位置	类型	必选	说明
`Authorization`	header	string	是	EasyAPI API Key。格式：Bearer <API_KEY>
`Content-Type`	header	string	是	multipart/form-data

请求体

名称	类型	必选	说明
`image`	file	是	PNG 正方形参考图
`n`	integer	否	变体数量，默认 1
`size`	string	否	输出尺寸：256x256、512x512 或 1024x1024（依模型支持）
`response_format`	string	否	url 或 b64_json

示例

# multipart/form-data 表单字段示例
image=@reference.png
n=1
size=1024x1024
response_format=url

响应示例

{
  "created": 1718452900,
  "data": [
    {
      "url": "https://cdn.example.com/images/img_dalle3_7c2f9a1b_var.png"
    }
  ]
}