DALL·E 3 图片生成 API 参考

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

字段	值
Base URL	`https://token.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://token.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	是	图像模型 ID，如 gpt-image-1、qwen-image-2.0-pro、seedream-4.0；缺失返回 400 model is required
`prompt`	string	是	图像文本描述。gpt-image-1 上限 32000 字符
`n`	integer	否	生成张数，1–10，默认 1；多图按张计费
`size`	string	否	输出尺寸。gpt-image-1 支持 1024x1024、1536x1024、1024x1536 或 auto，并参与费用预估
`response_format`	string	否	url 或 b64_json。gpt-image-1 不支持该参数，传入可能被上游拒绝
`stream`	boolean	否	透传字段；当前图像为同步链路，不据此分流

示例

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

返回示例

{
  "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://token.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。