当前位置: 首页 > api商店 > 文生图 · NanoBanana2 · API 说明
文生图 · NanoBanana2

GPT

模型 ID 34 图像
模型说明
Google NanoBanana2 图像生成:支持 1K/2K/4K 高清出图、多种宽高比、最多 14 张参考图一句话 PS;异步提交后由后台轮询拉取结果,按成功生成张数计费。

进入对话页

  • 接口说明
  • 调用示例
  • Markdown

左侧为章节切换,右侧为对应内容。

请求头(鉴权)
字段名 类型 必填 说明
Authorization string Bearer 令牌,格式为 Bearer {应用ID}-{应用密钥}(仅在第一个 - 处分割,密钥本身可含连字符)。应用 ID 与密钥在会员中心「我的应用」获取。兼容 OpenAI SDK:将 {应用ID}-{应用密钥} 作为 api_key 传入即可自动携带本请求头。

对接 HTTP 接口请使用上表 Authorization: Bearer {应用ID}-{应用密钥};兼容 OpenAI SDK(将 {应用ID}-{应用密钥} 作为 api_key)。站内网页另有 Cookie 兼容方式,不在此列出。

POST /v1/chat、POST /v1/chat/stream — JSON 请求体根字段

非流式与流式使用同一请求体结构;流式请使用 …/v1/chat/stream 路径。

多轮与上下文:接口按当次请求里的 messages 处理对话,不会替你「记住」上一轮正文。续聊须由客户端在 body 中组装完整历史(含此前的 user / assistant 等)。

字段名 类型 必填 说明
model_id int 模型主键;本页文档对应 `model_id=34`。
messages array 消息对象数组(见 messages[])。至少一条;多轮时须在数组内按顺序包含完整历史(user/assistant/system 等)。按本次列表处理对话,不自动补全缺省轮次。
temperature number 采样温度,默认 0.7;是否生效取决于具体模型。
max_tokens int 或 null 生成长度上限(token);null 表示使用默认。
stream bool 请求体字段,默认 false。**是否流式由 URL 决定**:流式请 POST `/v1/chat/stream`;`/v1/chat` 为非流式。勿仅靠本字段切换 SSE。
attachments array 附件数组,默认 [](见 attachments[])。服务端会把附件整理为模型可识别的上下文(如追加 system 说明 URL 列表)。
extra object 任意 JSON 对象,默认 {}。模型专有参数放于此(如数字人 image_url/audio_url/parameters;文生图/视频类 prompt、尺寸等)。服务端可能合并内部保留字段;请勿使用以下划线 `_` 开头的键名作为业务自定义字段。
messages[] — 单条消息

数组顺序即对话顺序;多轮时把历史轮次一并列入本数组即可。

字段名 类型 必填 说明
role string 角色:如 user、assistant、system 等,与 OpenAI Chat Completions 约定一致。
content string 该轮文本内容。多轮时 assistant 一般为上一轮模型输出,由客户端保存后在后续请求的 messages 中写回。
images array 或 null 历史消息中的多模态图片结构,会话回放用;元素为对象,字段因模型而异。
audios array 或 null 历史消息中的音频结构,会话回放用。
attachments[] — 单条附件
字段名 类型 必填 说明
url string 附件可访问 URL(须能被服务端拉取)。
filename string 或 null 原始文件名,便于展示或日志。
mime string 或 null MIME 类型,如 image/png。
extra object 附件级扩展信息,默认 {}。
本页示例 JSON 涉及字段(model_id=34 · NanoBanana2 图片)

提示词写在 **`messages`** 中。**`extra.size`** 为输出分辨率(1K/2K/4K),**`extra.aspectRatio`** 为宽高比;**`extra.urls`** 为参考图 URL 数组(最多 14 张,须公网可访问)。异步提交后 **`GET /v1/video-task/{job_id}`** 轮询;计费按成功生成 **0.17 元/张**(售价)。

下列说明与下方「调用示例」JSON 对齐,由本站配置维护。

字段名 类型 必填 说明
model_id int 须为 `34`,与本页模型编号一致。
messages[].content string 图片生成/编辑提示词,对应上游 `prompt`;可描述画面主体、风格、构图,或说明如何编辑参考图。
attachments array 站内上传的参考图(≤14);网关会整理为 `extra.urls` 数组提交上游。
extra.size string 输出分辨率:`1K`(默认)、`2K`、`4K`;分辨率越高生成越慢。
extra.aspectRatio string 宽高比:`auto`(默认)、`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`5:4`、`4:5`、`21:9`。
extra.urls array 参考图 URL 数组(最多 14 张);有参考图时可用于一句话 PS/图生图编辑。