Nano Banana Pro API 开发者参考

Nano Banana Pro API 视觉生成平台开发者参考指南，基于先进机器学习技术。

查看价格了解 Nano Banana Pro API 订阅方案

Nano Banana Pro API 概览

Nano Banana Pro API 视觉生成服务，让您连接先进的机器学习引擎，通过文本提示词和参考图片生成高质量图像。我们的解决方案提供了简洁的 REST 接口，具备全面的任务管理和实时通知功能。

Nano Banana Pro API 核心功能

• Nano Banana Pro API 文本转图像功能，采用最先进的机器学习引擎。
• Nano Banana Pro API 支持参考图片（最多4张）。
• Nano Banana Pro API 异步任务处理，可实时跟踪进度。
• Nano Banana Pro API 提供 Webhook 通知，用于即时状态变更。
• Nano Banana Pro API RESTful 接口，返回结构化的 JSON 数据。
• Nano Banana Pro API Bearer 令牌认证机制。

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Nano Banana Pro API 快速入门

1. 访问我们的官网，创建 Nano Banana Pro API 账户并获取访问凭证。
2. 在 Authorization 请求头中包含您的 Nano Banana Pro API 认证令牌。
3. 向 Nano Banana Pro API 图像生成端点发送 POST 请求。
4. 使用返回的 Nano Banana Pro API 任务ID来检查处理状态。
5. 处理完成后，获取您通过 Nano Banana Pro API 生成的图像。

访问认证

所有 API 请求都必须使用 Bearer token 进行有效认证。请在每个请求的 Authorization 请求头中附上您的 API 密钥。

认证方法

在 Authorization 请求头中加入您的 API 凭据，即可使用 HTTP Bearer token 认证：

Authorization: Bearer <your-api-key>

API 密钥格式示例

Authorization: Bearer dk-1234567890abcdef

请求示例

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

有效认证

✅ API 凭据未过期
✅ 账户注册状态正常
✅ 账户余额充足

常见问题

❌ 请求中缺少 API 凭据
❌ API 密钥无效或格式错误
❌ 账户已禁用或访问权限被撤销

Nano Banana Pro API 图像生成

使用 Nano Banana Pro API 创建图像。该 API 采用先进的机器学习技术，支持灵活的文本提示词和参考图像。

API 端点

POST /api/image/gen

请求参数

Parameter	Type	Required	Description
model	string	Yes	Model identifier (e.g., "google/gempix2")
prompt	string	Yes	Text prompt describing the image
images	array	No	Reference image URLs (max 4)
callback_url	string	No	Webhook URL for completion notifications

使用示例

基础图像创建

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

基于参考图像的高级生成

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

响应格式

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

错误处理

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

Nano Banana Pro API 任务状态

使用Nano Banana Pro API图像生成端点返回的任务ID，来查询图像生成任务的状态和结果。

API 端点

GET /api/task/query?task_id=<task_id>

查询参数

Parameter	Type	Required	Description
task_id	string	Yes	Unique task identifier returned from generation endpoint

请求示例

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Nano Banana Pro API 任务状态类型

pending - Nano Banana Pro API 任务已创建，等待开始处理

submitted - Nano Banana Pro API 任务已排队，等待生成

in_progress - Nano Banana Pro API 任务正在处理中

success - Nano Banana Pro API 任务成功完成，生成的图像已就绪

failed - Nano Banana Pro API 任务遇到错误，无法完成

错误响应

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Nano Banana Pro API 数据结构

Nano Banana Pro API请求和响应中使用的所有数据格式和模式的完整参考。

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

Field	Type	Description
image	string	Image URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}

Field	Type	Description
result	array	Array of ImageGenResult objects (null if failed)
status	string	Final task status (success/failed)
task_id	string	Unique task identifier
consumed	string	Credits consumed by the task
status_reason	object	Status details including error message if failed

Nano Banana Pro API 支持的模型

google/gempix2Nano Banana image generation model

google/gemini-2.5-flash-imageGemini 2.5 Flash image model

错误管理

错误处理完整指南，包含 API 响应码解读。所有错误信息均采用统一格式，方便有效排查问题。

HTTP 状态码

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

错误处理最佳实践

处理响应数据前，务必检查 HTTP 状态码。
遇到 500 错误时，采用指数退避策略重试。
为便于调试，请记录包含完整上下文的错误信息。
发送请求前先验证输入参数，以避免 400 错误。
通过让客户端刷新 API 凭据来解决认证问题。
以合理的时间间隔监控任务进度，避免过于频繁地轮询状态。
尽可能使用 webhook 通知，以避免持续轮询任务完成状态。

错误处理示例 (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}