Gemini Image Model

集成Google官方文生图最新模型，Gemini 2.5 Flash Image（又称 Nano Banana）现已在 TTAPI 中提供！

此文档已停止维护，最新文档地址：https://docs.ttapi.io

Gemini 图片生成

使用gemini-3-pro-image-preview模型，同步任务生成时间较长，建议使用 https://api.ttapi.org 网关

POST https://api.ttapi.io/gemini/image/generate

根据文本提示生成图像或修改图像。注意：非官方原格式对话式交互。

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
prompt	string	是	生成图像或修改图像描述词
refer_images	array[string]	否	垫图url地址，支持多图 [ "https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg", "https://cdn.ttapi.io/demo/2025-03-30/5d17dd5207daeeac86bcecd2d6405a0.jpg" ]
mode	string	是	模型版本： gemini-2.5-flash-image-preview gemini-2.5-flash-image gemini-3-pro-image-preview gemini-3.1-flash-image-preview
aspect_ratio	string	否	图片比例 注意：gemini-2.5-flash-image-preview 模型不可用 1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9 1:4 仅gemini-3.1-flash-image-preview 可用 4:1 仅gemini-3.1-flash-image-preview 可用 1:8 仅gemini-3.1-flash-image-preview 可用 8:1 仅gemini-3.1-flash-image-preview 可用 默认1:1
image_size	string	否	图片分辨率，当前只在 gemini-3-pro-image-preview 模型下生效 可选值：1K 2K 4K 512px 仅gemini-3.1-flash-image-preview 可用 默认值：1K 注意此处为大写的“K”
google_search	boolean	否	是否启用谷歌网页搜索 true - 启用 false - 不启用 默认：false
image_search	boolean	否	是否启用谷歌图片搜索 true - 启用 false - 不启用 默认：false
thinking_level	string	否	思考等级，可选范围： Minimal High 仅gemini-3.1-flash-image-preview 可用

请求示例

Python

import requests

endpoint = "https://api.ttapi.io/gemini/image/generate"

headers = {
    "TT-API-KEY": your_key
}

data = {
    "prompt": "a cute cat",
    "mode": "gemini-2.5-flash-image-preview"
}

response = requests.post(endpoint, headers=headers, json=data)

print(response.status_code)
print(response.json())

Node

返回示例

200

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "prompt": "a cute cat",
    "refer_images": null,
    "image_url": "https://cdn.ttapi.io/other/2025-09-10/8b46aa28-4433-455f-bf5c-f5ccea48baf2.png",
    "quota": 2
  }
}