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。