Nano Banana 文生图

google/nano-banana/text-to-image

Gemini 2.5 Flash 标准版。轻量极速。兼顾速度与成本，是批量生成与快速原型设计的最佳选择。

示例

参数

名称	类型	默认	约束	说明
prompt *提示词	textarea	—	≤ 5000 chars	描述您想要生成的图像。请具体说明主题、风格、颜色和构图。
aspect_ratio宽高比	select	16:9	1:1 \| 3:2 \| 2:3 \| 3:4 \| 4:3 \| 4:5 \| 5:4 \| 9:16 \| …	选择生成图像的宽高比。

输出字段

字段	类型	说明
images	array<string>	Generated image URLs

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/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A futuristic eco-city skyline at sunset, featuring organic spiraling skyscrapers covered in lush vertical gardens and cascading waterfalls. Sleek flying vehicles weaving through the towers, warm golden hour lighting reflecting off glass surfaces. Photorealistic, architectural visualization, clean composition, 8k resolution, wide angle lens.",
    "aspect_ratio": "16:9"
  }
}'

# 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/text-to-image",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "A futuristic eco-city skyline at sunset, featuring organic spiraling skyscrapers covered in lush vertical gardens and cascading waterfalls. Sleek flying vehicles weaving through the towers, warm golden hour lighting reflecting off glass surfaces. Photorealistic, architectural visualization, clean composition, 8k resolution, wide angle lens.",
            "aspect_ratio": "16:9"
        }
    },
)
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/text-to-image", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "A futuristic eco-city skyline at sunset, featuring organic spiraling skyscrapers covered in lush vertical gardens and cascading waterfalls. Sleek flying vehicles weaving through the towers, warm golden hour lighting reflecting off glass surfaces. Photorealistic, architectural visualization, clean composition, 8k resolution, wide angle lens.",
      "aspect_ratio": "16:9"
    }
  }),
});
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);