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。

图像变体

POSThttps://token.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"
    }
  ]
}