Nano Banana 2.1 文生图
google/nano-banana-2.1/text-to-image
Google 文生图,支持 1K–4K 输出和思考强度设置,按 token 用量结算。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | ≤ 5000 chars | 描述您想要生成的图像。请具体说明主题、风格、颜色、光线和构图,图中需要出现的文字请用引号标出。 |
| aspect_ratio宽高比 | select | 1:1 | 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | … | 选择生成图像的宽高比。 |
| resolution分辨率 | select | 1k | 1k | 2k | 4k | 选择输出图像的长边分辨率。分辨率越高,消耗越多、耗时越长。 |
| thinking_level推理强度 | select | medium | minimal | medium | high | 控制模型生成前的推理量。强度越高,构图与细节越好,但耗时更长。 |
| enable_web_search联网搜索 | boolean | false | — | 允许模型按提示词需要进行搜索。开启选项不固定加费,本接口按返回的 token 用量结算。 |
| enable_image_search图像搜索 | boolean | false | — | 允许模型按提示词需要进行搜索。开启选项不固定加费,本接口按返回的 token 用量结算。 |
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| text | string | |
| images | array<string> |
API
通过统一 REST API 调用本模型;在 API Keys 页获取密钥。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/text-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "1:1",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": false,
"enable_image_search": false
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/text-to-image",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "1:1",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": False,
"enable_image_search": False
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/text-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "1:1",
"resolution": "1k",
"thinking_level": "medium",
"enable_web_search": false,
"enable_image_search": false
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);文档
Nano Banana 2.1 文生图
通过文字提示词生成图片。
输入参数
| 参数 | 必填 | 类型、限制与默认值 |
|---|---|---|
prompt | 是 | string;最多 5,000 字符。 |
aspect_ratio | 否 | string;默认 1:1。 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9 |
resolution | 否 | string; 1k / 2k / 4k; default: 1k. |
thinking_level | 否 | string;minimal / medium / high;默认 medium。 |
enable_web_search | 否 | boolean;默认 false。允许按需搜索,是否实际使用由模型判断。 |
enable_image_search | 否 | boolean;默认 false。允许按需搜索,是否实际使用由模型判断。 |
Token 定价
| 计量项 | 美元 / 百万 token | 积分 / 百万 token |
|---|---|---|
| 输入(文本及参考图片) | $1.50 | 150 |
| 文本输出及思考 | $7.50 | 750 |
| 图片输出 | $30.00 | 3000 |
采用 Google Standard token 费率;1 美元 = 100 积分。参考图片按输入 token 收费,不按张固定加价。本接口仅按 token 用量结算,搜索开关不触发固定加费。
提交时仅预扣图片部分:1K / 2K / 4K 分别为 3.36 / 5.04 / 11.34 积分;完成后按 token 总费用多退少补。最终金额向上取整至 0.01 积分,账户折扣另算。
API 示例
POST https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2.1/text-to-image
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"prompt": "A quiet bookstore at sunrise, with a sign reading OPEN.",
"resolution": "1k",
"thinking_level": "medium"
}
}
GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
提交一次,再用返回的 task_uuid 查询。完成后 output.images 为图片 URL 数组;output.text 可能包含附带文字。
相关模型
z-image-spicy/text-to-image
从文本提示生成高质量图片,支持 256 至 1536 像素自定义尺寸、智能提示词扩写和随机种子,适合创意设计与批量出图。
xAI Grok Imagine Image v2.0 文生图
xAI Grok Imagine Image V2.0 文生图可根据文本提示词生成高质量图片,并支持配置宽高比、分辨率和质量,适用于创意视觉、社交内容、营销素材和生产工作流。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
Qwen Image 3.0 Pro 文生图
Qwen Image 3.0 Pro 是一款专业级文生图模型,具备卓越画质和先进的提示词理解能力。最高支持 2k。提供开箱即用的 REST inference API,性能出色,无冷启动,价格实惠。
ai/prefect-pony-xl 动漫风格图片生成模型
Prefect Pony XL 可高质量生成动漫风格图片,适用于角色立绘和插画创作。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
OpenAI GPT Image 2 文本生成图片
OpenAI 的 GPT Image 2 文本生成图片模型可根据自然语言提示词生成高质量图片。提供即用型 REST 推理 API,性能最佳,无冷启动,价格实惠。
OpenAI GPT Image 2 Edit 图像编辑
OpenAI 的 GPT Image 2 Edit 可通过自然语言指令结合一张或多张参考图片进行图像编辑。提供即用型 REST 推理 API,性能最佳,无冷启动,价格实惠。
OpenAI GPT Image 2.5 Sunburst 文本生成图片
面向复杂构图和高要求生产场景的高保真图片生成,最高支持 4K 输出。
OpenAI GPT Image 2.5 Flare 文本生成图片
根据自然语言提示词快速生成高质量图片,兼顾速度与效果,最高支持 4K 输出。