WaveSpeedAI Nano Banana Pro 图像生成/编辑

通过 WaveSpeed AI 平台，使用 Google 的 Nano Banana Pro 模型进行图像生成与编辑。支持文本到图像（text-to-image）生成，以及基于自然语言的图像编辑，最多可输入 14 张图像。

身份验证

export WAVESPEED_API_KEY="your-api-key"

在 wavespeed.ai/accesskey 获取您的 API 密钥。

快速开始

文本到图像

import wavespeed from 'wavespeed';

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/text-to-image",
  { prompt: "一幅宁静的日式庭院水彩画，盛开着樱花" }
))["outputs"][0];

图像编辑

images 参数接受一个图像 URL 数组。若您使用本地文件，请先调用 wavespeed.upload() 上传并获取 URL。

import wavespeed from 'wavespeed';

// 上传本地图像以获取 URL
const imageUrl = await wavespeed.upload("/path/to/photo.png");

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/edit",
  {
    images: [imageUrl],
    prompt: "将天空替换为壮丽的日落场景"
  }
))["outputs"][0];

您也可以直接传入已有的图像 URL：

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/edit",
  {
    images: ["https://example.com/photo.jpg"],
    prompt: "将天空替换为壮丽的日落场景"
  }
))["outputs"][0];

API 接口端点

文本到图像

模型 ID： google/nano-banana-pro/text-to-image

根据文本提示生成图像。

参数

示例

import wavespeed from 'wavespeed';

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/text-to-image",
  {
    prompt: "黄金时刻，一辆红色复古保时捷 911 行驶在蜿蜒的山路上，照片级写实风格",
    aspect_ratio: "16:9",
    resolution: "2k",
    output_format: "png"
  }
))["outputs"][0];

图像编辑

模型 ID： google/nano-banana-pro/edit

使用自然语言提示编辑现有图像。最多支持 14 张输入图像。

参数

示例

import wavespeed from 'wavespeed';

// 先上传本地图像，或直接使用已有 URL
const imageUrl = await wavespeed.upload("/path/to/living-room.png");

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/edit",
  {
    images: [imageUrl],
    prompt: "将墙面颜色更改为温暖的赤陶色，并添加室内绿植",
    aspect_ratio: "16:9",
    resolution: "4k",
    output_format: "png"
  }
))["outputs"][0];

多图像编辑

// 上传多张本地图像
const faceUrl = await wavespeed.upload("/path/to/face.png");
const hairstyleUrl = await wavespeed.upload("/path/to/hairstyle.png");

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/edit",
  {
    images: [faceUrl, hairstyleUrl],
    prompt: "将第二张图像中的发型应用到第一张图像中的人物上"
  }
))["outputs"][0];

高级用法

同步模式

启用同步模式可发起单次请求并阻塞等待结果，无需轮询：

const output_url = (await wavespeed.run(
  "google/nano-banana-pro/text-to-image",
  { prompt: "一家咖啡馆的极简主义 Logo" },
  { enableSyncMode: true }
))["outputs"][0];

自定义客户端（含重试配置）

import { Client } from 'wavespeed';

const client = new Client("your-api-key", {
  maxRetries: 2,
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

const output_url = (await client.run(
  "google/nano-banana-pro/text-to-image",
  { prompt: "黄昏时分的未来主义城市景观" }
))["outputs"][0];

使用 runNoThrow 进行错误处理

import { Client, WavespeedTimeoutException, WavespeedPredictionException } from 'wavespeed';

const client = new Client();
const result = await client.runNoThrow(
  "google/nano-banana-pro/text-to-image",
  { prompt: "一只戴着高顶礼帽的猫" }
);

if (result.outputs) {
  console.log("图像 URL：", result.outputs[0]);
  console.log("任务 ID：", result.detail.taskId);
} else {
  console.log("失败：", result.detail.error.message);
  if (result.detail.error instanceof WavespeedTimeoutException) {
    console.log("请求超时 — 请尝试增加超时时间");
  } else if (result.detail.error instanceof WavespeedPredictionException) {
    console.log("模型推理失败");
  }
}

宽高比选项

分辨率与定价

提示词编写技巧

• 具体且详尽：例如“黄金时刻，一辆红色复古保时捷 911 行驶在蜿蜒的山路上”，而非“一辆车”；
• 加入风格关键词：“数字艺术”、“油画”、“照片级写实”、“水彩”、“电影感”；
• 图像编辑时明确描述变更：“将天空替换为壮丽的日落场景”；
• 多图像编辑时按位置引用图像：“将第二张图像的风格应用到第一张图像上”；
• 支持多语言文字渲染：模型支持图像内文字，并自动完成翻译；
• 使用镜头语言控制：“浅景深”、“广角”、“俯视视角”。

安全约束

• 禁止任意 URL 加载：仅使用可信来源的图像 URL。切勿在未经校验的情况下加载不可信或用户提供的图像 URL。
• API 密钥安全：妥善保管您的 WAVESPEED_API_KEY。切勿将其硬编码至源码文件中，也不得提交至版本控制系统。请使用环境变量或密钥管理服务。
• 输入校验：仅传入本文档中明确定义的参数。在发送请求前，应对提示词内容及图像 URL 进行有效性校验。