Nano-banana-3.1-Flash-Lite官方格式

OpenAPI Specification

接口：POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent（完整地址 https://api.allyang.cn/v1beta/models/gemini-3.1-flash-lite-image:generateContent）

说明：本页按上游 Gemini 格式接入，请求体为 contents + generationConfig 结构。

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

• Content-Type：必填，固定 application/json。
• Authorization：可选，string，默认 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

• contents：必填，数组，元素为对象：
  • parts：数组，元素为对象；每个元素必含 inlineData，另可选带 text。
    • inlineData：object，含 data（string，必填，图片的 base64 编码内容）与 mimeType（string，必填，如 image/png）。
    • text：string，文本内容。
  • role：string，如 user。
• generationConfig：可选，object：
  • imageConfig：object，含 aspectRatio（string）与 imageSize（string，取 1K、2K、4K、512）。
  • responseModalities：数组，元素为 string，示例取 IMAGE。

必填字段：contents。

请求示例

• contents：一条 role 为 user 的消息，parts 中依次放两张 inlineData（mimeType 均为 image/png）与一段 text（内容 hi）。
• generationConfig：imageConfig.aspectRatio 取 3:4、imageConfig.imageSize 取 2K，responseModalities 取 ["IMAGE"]。

响应

• 200：成功；返回 JSON 对象，字段结构原文未给出，待补。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。