跳转到主要内容
POST
文生图:根据文本描述生成图片
右侧的交互式 Playground 支持下拉选择参数(宽高比、分辨率、响应类型等)。请在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),即可一键发送请求测试。
场景说明:本页用于「文本生成图片」。只需输入提示词即可,无需上传任何图片。如需根据现有图片做编辑,请使用 图片编辑接口
🖥️ 浏览器 Playground 限制(重要)本接口的响应里包含 base64 编码的图片(inlineData.data,数 MB 量级)。受浏览器渲染限制,右侧 Playground 在收到响应后可能弹出 请求时发生错误: unable to complete request ——实际请求已经成功,只是浏览器无法把这么长的 base64 显示出来。推荐做法(小白零踩坑):
  • 直接复制下方”代码示例”中的 Python / Node.js / cURL 到本地运行,代码会自动 base64.b64decode 并把图片保存为本地文件
  • 如要在浏览器里试 Playground,把 imageSize 设为最小档(如 1K),缩小响应体积。
图片 API 全部为同步调用:没有异步任务 ID,客户端断开连接结果即丢失、但请求仍会计费。请为本模型设置足够大的 timeout,详见 图片 API 调用须知与最佳实践

代码示例

Python

cURL

Node.js

参数说明速查

详细的参数文档、可选值和默认值请查看右侧 Playground 中的字段说明,所有 enum 类型字段(如 aspectRatioimageSize)都支持下拉选择,无需手动输入。
不支持的功能以下谷歌官方功能在 API易 中不支持,需要单独计费:
  • Grounding with Google Search(谷歌搜索增强):通过 tools: [{"google_search": {}}] 调用实时搜索信息
  • thinkingConfig(思维模式):仅 Nano Banana 2 支持,Nano Banana Pro 不支持此参数
如需搜索增强功能,请联系客服了解单独计费方案。

授权

Authorization
string
header
必填

在 API易控制台获取的 API Key

请求体

application/json
contents
object[]
必填

内容数组,包含文本提示词

generationConfig
object
必填

响应

成功生成图片

candidates
object[]

生成结果数组

usageMetadata
object