Skip to content

nano-banana API Examples

由于nano-banana模型是一个多模态模型,OpenAI SDK 目前不支持直接访问该模型。您需要使用request方式访问nano-banana模型。

基础配置

在开始使用API之前,请确保您已经获取了API Key。如果还没有,请参考创建API Key

基础信息

  • API Base URL: https://api.agentsflare.com/googleapi/google/v1/models/gemini-3-pro-image-preview:generateContent
  • 认证方式: Bearer Token
  • 内容类型: application/json

请求示例

bash
curl -X POST "https://api.agentsflare.com/googleapi/google/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API-KEY" \
  -d '{
    "contents": [{
      "parts": [{"text": "生成一张跑车的展示图片。"}]
    }],
    "generationConfig": {
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "1K"
      }
    }
  }'
python
import requests

url = "https://api.agentsflare.com/googleapi/google/v1/models/gemini-3-pro-image-preview:generateContent"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer API-KEY"
}
data = {
    "contents": [{
        "parts": [{"text": "生成一张跑车的展示图片。"}]
    }],
    "generationConfig": {
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Collections;

public class NanoBananaExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(new URI("https://api.agentsflare.com/googleapi/google/v1/models/gemini-3-pro-image-preview:generateContent"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer API-KEY")
            .POST(HttpRequest.BodyPublishers.ofString("""
            {
                "contents": [{
                    "parts": [{"text": "生成一张跑车的展示图片。"}]
                }],
                "generationConfig": {
                    "imageConfig": {
                        "aspectRatio": "16:9",
                        "imageSize": "1K"
                    }
                }
            }
            """))
            .build();
javascript
const axios = require('axios');

const url = 'https://api.agentsflare.com/googleapi/google/v1/models/gemini-3-pro-image-preview:generateContent';
const headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer API-KEY'
};
const data = {
    "contents": [{
        "parts": [{"text": "生成一张跑车的展示图片。"}]
    }],
    "generationConfig": {
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
};

axios.post(url, data, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));
go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"log"
	"net/http"
)

type RequestBody struct {
	Contents []struct {
		Parts []struct {
			Text string `json:"text"`
		} `json:"parts"`
	} `json:"contents"`
	GenerationConfig struct {
		ImageConfig struct {
			AspectRatio string `json:"aspectRatio"`
			ImageSize   string `json:"imageSize"`
		} `json:"imageConfig"`
	} `json:"generationConfig"`
}

响应实例

将data后的数据用base64编码转成图片即可.

json
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/jpeg",
              "data": "/9j/PoOcZyOaLe1tfs661unrf1P/Z"
            },
            "thoughtSignature": "EvzcWNXXAXOBvMMwZBfjm6U4n6io7E5K+3iawi5TnliFj8tlQmYhAxTh3sCGOdUCz7perrdCeV8NhgyYan"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 21,
    "candidatesTokenCount": 1234,
    "totalTokenCount": 1420,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 21
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "IMAGE",
        "tokenCount": 1120
      }
    ],
    "thoughtsTokenCount": 165
  },
  "modelVersion": "gemini-3-pro-image-preview",
  "responseId": "MK5kaf_nKdWU_uMPkciLkAY"
}

请求参数

参数详见Nano Banana image generation

本文档遵循 CC BY-SA 4.0 协议。