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。 真实扣费以控制台账单为准。