Skip to main content
POST
文生图:根据文本提示词生成图片
右側的互動式 Playground 支援直接線上除錯。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),選擇 model、輸入 prompt,按需填 width / height 後一鍵傳送即可。
場景說明:本頁用於「文本生成圖片」,只需提示詞。如果你要基於現有圖片做修改或雙圖融合,請使用 圖片編輯介面。
⚠️ 三個引數傳了就 400response_format、seed、negative_prompt 本系列都不接受,傳入返回 400 Invalid parameters: xxx。從 gpt-image / DALL·E 遷移的程式碼請先刪掉 response_format——返回值固定是 data[0].b64_json。
⚠️ 尺寸用 width + height,不用 size本端點傳 size 會被靜默忽略,恆出 1024×1024。請改用整數 width + height(必須成對),每維 ≥ 768、寬×高 ≤ 2,359,296(1536×1536 面積)。
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。1024×1024 出圖 Flash 約 17 秒、2.6 約 30 秒,建議客戶端超時 Flash ≥ 120 秒、2.6 ≥ 180 秒,詳見 圖片 API 呼叫須知與最佳實踐。

程式碼示例

Python(OpenAI SDK)

Python(原生 requests)

cURL

Node.js(原生 fetch)

一次要多張:併發請求

文生圖介面每次只返回 1 張(n 無效),要多張就併發:

引數說明速查

quality、output_format、background、style 等 OpenAI 習慣欄位會被靜默忽略,輸出恆為 PNG。

響應格式

響應欄位說明
  • b64_json 是純 base64,不帶 data:image/png;base64, 字首,可直接解碼,解碼後為 PNG。
  • 沒有 url 欄位,也不返回 revised_prompt。
  • 1024×1024 的 PNG 約 1.5–1.7 MB,base64 後響應體約 2.1–2.3 MB;1536×1536 約 4–5 MB,注意客戶端的響應體大小限制。
usage 不能用來核賬:prompt_tokens 恆為 1000 × 張數、output_tokens 恆為 0,是佔位值。本系列按張固定計費,真實扣費請以 API易 控制台賬單為準。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
model
enum<string>
預設值:MAI-Image-2.6-Flash
必填

模型 ID(大小写敏感)。2.6 画质优先,Flash 速度优先

可用選項:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
必填

提示词,支持中英文。要出现在图里的文字用引号括起来

範例:

"一家古风茶馆的门面,木质招牌上写着「API易 欢迎」,红灯笼,黄昏暖光,写实摄影"

width
integer
預設值:1024

输出宽度(像素)。每维 ≥ 768,宽×高 ≤ 2,359,296(1536×1536 面积), 必须与 height 成对传入;非 16 倍数向下取整。

必填範圍: x >= 768
範例:

1024

height
integer
預設值:1024

输出高度(像素),规则同 width

必填範圍: x >= 768
範例:

1024

回應

成功生成图片

created
integer

创建时间戳

範例:

1790999642

data
object[]

图片结果数组,文生图固定 1 项

usage
object

占位值,不能用于核账。 prompt_tokens 恒为 1000 × 张数、output_tokens 恒为 0。 真实扣费以控制台账单为准。