Nano Banana Pro API 入门指南

Nano Banana Pro API 是一个实用的、生产就绪的接口，用于使用最新的 Gemini 模型生成图像。本 Nano Banana Pro API 指南侧重于实际使用：如何编写提示词（prompts）、构建请求、解析响应，以及构建您的产品可以依赖的工作流。

如果您想要 Nano Banana 2 的官方概览、演示和产品背景，请从 Nano Banana 2 中心 开始。

什么是 Nano Banana Pro API？

Nano Banana Pro API 为您提供了一个简单的 REST 接口，用于高质量图像生成。您发送提示词和可选的参考，并接收可以在应用中存储和发布的图像输出。它专为需要一致结果、可重复工作流和可预测集成模式的团队而设计。

何时使用 Nano Banana Pro API

当您想要快速、按需的视觉效果而无需构建内部模型管道时，请使用 Nano Banana Pro API：

• 营销内容：用于广告和着陆页
• 产品图像：用于目录和电子商务列表
• 创意草稿：用于早期概念和情绪板

核心能力

该 API 围绕生产中至关重要的几个核心优势构建：

• 文本到图像生成：将自然语言转化为视觉效果
• 图像到图像创作：用于重新混合或基于现有镜头构建
• 感知参考输出：保持风格和主体一致
• 可扩展性能：支持批处理作业和自动化工作流

Nano Banana Pro API 快速入门

1. 获取访问权限

在 EvoLink 仪表板中创建一个帐户，然后为您的项目生成 API 密钥。将密钥保存在安全的密钥存储中，切勿在客户端代码中公开。

2. 发起您的第一个请求

这是一个最小的 cURL 示例。请将占位符替换为您的实际值。

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

3. 处理响应

响应通常包含元数据和图像 URL 或 ID 列表。请快速持久化结果，并将它们存储在您自己的存储层中以便长期访问。

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

您应该了解的核心参数

这些是您在调用 Nano Banana Pro API 时最常使用的参数：

• model：使用为您的帐户启用的模型。为草稿选择经济高效的层级，为最终资产选择高级层级。
• prompt：您的指令文本。明确主体、风格和情绪。
• size：适合您版面的宽高比或尺寸预设（正方形、纵向或横向）。
• quality：最终输出所需的分辨率层级。
• image_urls：可选的参考图像，如果您想保持主体或风格一致。

异步作业和图像 URL

许多团队异步运行 API：提交作业，轮询任务直到完成，然后下载并存储图像。URL 可能有时间限制，因此请将其视为短暂的，并在一准备好就将其移入您自己的存储中。

提示词（Prompt）手册

改善结果的最快方法是使用清晰的提示词结构。一个简单的公式很有效：

主体 + 上下文 + 风格 + 光照 + 构图 + 质量

以下是更实用的提示词技巧：

1. 具体 - 命名主体并描述关键细节。
2. 定义风格 - 逼真、水彩、电影感、编辑风格。
3. 控制构图 - 特写、广角、俯视或居中。

示例提示词

质量控制与迭代

将生成视为快速设计循环。从宽泛的提示词开始，然后迭代：

• 根据第一个输出添加或删除细节。
• 在细化主体之前锁定风格。
• 保存最佳提示词，以便您的团队以后可以重用它们。
• 当系列中的一致性很重要时，使用参考图像。

生产清单

在工作流中发布 Nano Banana Pro API 之前，请使用此清单：

• API 密钥存储在安全的服务器端密钥存储中
• 为您的主要用例记录基础提示词
• 输出图像保存到永久存储中

总结

Nano Banana Pro API 是通过干净的 REST 接口生成高质量视觉效果的可靠方法。从清晰的提示词开始，快速迭代，并记录您的最佳结果。对于快速发布的团队来说，这可以在无需繁重工具的情况下保持创意输出的流动。