Cách truy cập API Nano Banana Pro

Google vừa phát hành Nano Banana Pro, tên mã chính thức của Gemini 3 Pro Image, một mô hình đa phương thức hiện đại vượt trội trong việc tạo ảnh từ văn bản, chỉnh sửa ảnh và kiểm soát bố cục nâng cao. Các nhà phát triển hiện có thể truy cập công cụ mạnh mẽ này theo chương trình thông qua Gemini API. Các chi tiết cấu hình nhỏ thường quyết định liệu việc tích hợp của bạn thành công hay thất bại nhanh chóng.

💡

Trước khi tiếp tục, hãy tải xuống Apidog miễn phí — nó giúp đơn giản hóa việc kiểm thử các điểm cuối API của Nano Banana Pro, xác thực các tải trọng JSON và giả lập phản hồi mà không cần viết thêm mã. Apidog xử lý xác thực Gemini API một cách liền mạch, giúp bạn tập trung vào việc tạo lời nhắc thay vì gỡ lỗi tiêu đề.

button

Hướng dẫn này sẽ đưa bạn qua từng bước để truy cập và sử dụng API của Nano Banana Pro một cách hiệu quả.

Nano Banana Pro là gì và tại sao nên sử dụng API của nó?

Google DeepMind đã xây dựng Nano Banana Pro trên nền tảng Gemini 3 Pro. Nó cung cấp các đầu ra hình ảnh chất lượng studio mà các mô hình trước đây không thể sánh được. Đầu tiên, nó hiển thị văn bản bên trong hình ảnh với độ chính xác đặc biệt — hãy nghĩ đến các logo dễ đọc, biển báo đa ngôn ngữ hoặc chữ thư pháp được tạo kiểu phù hợp hoàn hảo với cảnh. Tiếp theo, nó hỗ trợ tới 14 hình ảnh đầu vào để pha trộn trong khi vẫn duy trì tính nhất quán trên tối đa năm đối tượng. Ngoài ra, các nhà phát triển còn kiểm soát góc máy ảnh, ánh sáng, độ sâu trường ảnh, phân loại màu sắc và thậm chí cả độ phân giải lên đến 4K.

Lời nhắc: Tạo một đồ họa thông tin về loài cây này, tập trung vào những thông tin thú vị

Hơn nữa, mô hình này còn dựa trên dữ liệu tìm kiếm Google theo thời gian thực khi bạn bật tính năng này. Điều này đảm bảo độ chính xác về mặt thực tế cho các sơ đồ, đồ họa thông tin hoặc mô hình sản phẩm. Mỗi đầu ra đều có dấu bản quyền SynthID để theo dõi nguồn gốc.

Bạn truy cập Nano Banana Pro thông qua Gemini API tiêu chuẩn, nhưng bạn chọn định danh mô hình cụ thể (gemini-3-pro-image-preview hoặc phiên bản kế nhiệm ổn định của nó). Cách tiếp cận này giúp mã của bạn tương thích với các biến thể Gemini khác, đồng thời mở khóa các khả năng hình ảnh cấp chuyên nghiệp.

Từng bước: Lấy khóa API Gemini của bạn

Thực hiện các bước sau để lấy thông tin đăng nhập:

Truy cập Google AI Studio và đăng nhập bằng tài khoản Google của bạn.

Nhấp vào nút "Get API key" (Lấy khóa API) ở thanh bên trái.

Tạo khóa mới hoặc sử dụng khóa hiện có.

Hoặc, trong Vertex AI:

Mở bảng điều khiển Vertex AI Studio.
Chọn "Generative AI" → "Model Garden."
Tìm Nano Banana Pro (được liệt kê là Gemini 3 Pro Image).
Nhấp vào "Enable API" (Bật API) và tạo thông tin đăng nhập.

Lưu trữ khóa một cách an toàn trong các biến môi trường. Không bao giờ mã hóa cứng nó trong các tệp nguồn.

Gọi API Nano Banana Pro từ Google AI Studio (Bắt đầu nhanh)

Bạn thường bắt đầu trong Google AI Studio để thử nghiệm nhanh. Đầu tiên, hãy truy cập ai.studio/banana-pro. Chọn "Nano Banana Pro" từ danh sách thả xuống mô hình.

Sau đó, chuyển sang tab "API" để xem các ví dụ curl được tự động điền khóa của bạn.

Dưới đây là một yêu cầu curl cơ bản:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{
        "text": "Tạo một hình ảnh chân thực 4K về một quả chuối vàng đang trôi nổi trong không gian với Trái Đất ở hậu cảnh, thêm lớp phủ văn bản: \"Nano Banana Pro\""
      }]
    }],
    "generationConfig": {
      "responseModal": "IMAGE"
    }
  }'

Điểm cuối này vẫn giống như các mô hình Gemini khác — chỉ tên mô hình thay đổi.

Sử dụng SDK Python chính thức cho Nano Banana Pro

Hầu hết các nhà phát triển đều ưa thích thư viện máy khách Python vì nó tự động xử lý các lần thử lại, truyền dữ liệu và các loại mime. Đầu tiên, hãy cài đặt nó:

pip install -U google-generativeai

Cấu hình thư viện và tạo một hình ảnh:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel('models/gemini-3-pro-image-preview')

response = model.generate_content(
    "Một thành phố tương lai vào giờ vàng với những chiếc ô tô bay và dòng chữ 'Chào mừng đến năm 2042' trên bảng quảng cáo, độ phân giải 4K",
    generation_config=genai.types.GenerationConfig(
        response_mime_type="image/png"
    )
)

response.candidates[0].content.parts[0].inline_data.data  # base64 image

Lưu đầu ra như sau:

with open("output.png", "wb") as f:
    f.write(response.candidates[0].content.parts[0].inline_data.data)

SDK trừu tượng hóa các chi tiết cấp thấp, vì vậy bạn tập trung vào kỹ thuật nhắc lệnh (prompt engineering).

Xử lý chỉnh sửa hình ảnh và đầu vào đa hình ảnh

Nano Banana Pro nổi bật trong các tác vụ chỉnh sửa. Tải lên hình ảnh như một phần của lời nhắc. Ví dụ:

import PIL.Image

img = PIL.Image.open("reference.jpg")

response = model.generate_content(
    [img, "Chỉnh sửa ảnh này: thay đổi ban ngày thành hoàng hôn kịch tính, thêm hiệu ứng bokeh, giữ nguyên chủ thể"]
)

Bạn kết hợp nhiều hình ảnh và văn bản một cách liền mạch. Mô hình duy trì tính nhất quán của chủ thể trên các tham chiếu.

Các tính năng nâng cao: Nền tảng kiến thức (Grounding), Cài đặt an toàn và Kiểm soát

Bật tính năng nền tảng kiến thức từ Google Search để đưa vào các thông tin thực tế theo thời gian thực:

"systemInstruction": {
  "parts": [{"text": "Sử dụng nền tảng kiến thức từ tìm kiếm cho các yếu tố thực tế"}]
}

Điều chỉnh cài đặt an toàn để chặn hoặc cho phép các danh mục:

model = genai.GenerativeModel(
    'models/gemini-3-pro-image-preview',
    safety_settings=[
        {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_NONE"}
    ]
)

Chỉ định tỷ lệ khung hình và chất lượng:

generation_config=genai.types.GenerationConfig(
    candidate_count=1,
    temperature=0.7,
    extra_params={
        "aspect_ratio": "16:9",
        "quality": "cao nhất"
    }
)

Kiểm thử và gỡ lỗi các cuộc gọi API Nano Banana Pro bằng Apidog

Các lệnh curl thủ công phù hợp cho các thử nghiệm một lần, nhưng Apidog thay đổi quy trình làm việc của bạn. Nhập thông số kỹ thuật OpenAPI chính thức của Gemini vào Apidog, và nó sẽ tự động tạo tất cả các điểm cuối, bao gồm cả các biến thể của Nano Banana Pro.

Dưới đây là những lợi ích bạn nhận được:

Trực quan hóa các lược đồ JSON cho các yêu cầu generateContent.
Lưu các môi trường (khóa dev/staging/prod).
Liên kết các yêu cầu và xác nhận phản hồi.
Giả lập API cục bộ để phát triển ngoại tuyến.
Tạo mã máy khách bằng hơn 20 ngôn ngữ ngay lập tức.

Chẳng hạn, tạo một yêu cầu mới trong Apidog, dán điểm cuối Gemini, thêm khóa API của bạn vào tiêu đề và gửi các tải trọng đa phần phức tạp với hình ảnh đã tải lên chỉ trong vài giây. Apidog xác thực các trường bắt buộc ngay cả trước khi bạn nhấn "Gửi", giúp ngăn chặn các lỗi 400 phổ biến.

Nhiều nhóm báo cáo rằng chu kỳ lặp lại nhanh hơn 50-70% sau khi chuyển sang Apidog để kiểm thử Gemini API.

Triển khai Nano Banana Pro trên Vertex AI để sản xuất

Người dùng doanh nghiệp mở rộng quy mô với Vertex AI. Tạo một điểm cuối tùy chỉnh:

Truy cập Vertex AI → Model Garden.
Triển khai "Gemini 3 Pro Image (Nano Banana Pro)."
Cấu hình loại máy và tự động điều chỉnh quy mô (autoscaling).
Gọi điểm cuối dự đoán bằng Vertex SDK.

Con đường này cung cấp các điểm cuối riêng tư, ghi nhật ký và tích hợp giám sát với Cloud Operations.

Giá cả, Giới hạn tốc độ và Các phương pháp hay nhất

Nano Banana Pro có chi phí cao hơn các mô hình nhẹ hơn do yêu cầu tính toán cao hơn. Hãy kiểm tra mức giá mới nhất trên trang giá Gemini API vì chúng có thể thay đổi trong giai đoạn xem trước.

Thực hiện chiến lược lùi mũ (exponential backoff) cho các lần thử lại. Lưu vào bộ nhớ đệm (cache) các lời nhắc phổ biến khi có thể. Hơn nữa, chỉ nhóm các yêu cầu không liên quan nếu trường hợp sử dụng của bạn cho phép — tạo hình ảnh chưa hỗ trợ nhóm thực sự.

Luôn bao gồm các lời nhắc rõ ràng, có cấu trúc. Tham khảo hướng dẫn lời nhắc chính thức cho Nano Banana Pro để tối đa hóa chất lượng.

Khắc phục sự cố thường gặp

Bạn sẽ gặp lỗi "model not found" nếu sử dụng sai định danh. Xác nhận rằng bạn đang nhắm mục tiêu gemini-3-pro-image-preview trong giai đoạn xem trước có trả phí.

Đối với lỗi xác thực, hãy tạo lại khóa của bạn và kiểm tra xem không có khoảng trắng thừa nào. Nếu hình ảnh xuất hiện dấu bản quyền một cách bất ngờ, hãy nhớ rằng chỉ một số cấp độ nhất định mới loại bỏ dấu hiệu nhận biết đó.

Khi đầu ra có vẻ bị kiểm duyệt, hãy điều chỉnh rõ ràng các ngưỡng an toàn.

Kết luận

Giờ đây bạn đã có đủ kiến thức để truy cập và tích hợp API Nano Banana Pro một cách hiệu quả. Bắt đầu với Google AI Studio để có kết quả tức thì, chuyển sang Python SDK để viết script và tận dụng Apidog để hợp lý hóa việc kiểm thử và gỡ lỗi.

Sự kết hợp các khả năng của Gemini 3 Pro Image dưới tên Nano Banana Pro mở ra những khả năng mới cho thiết kế tự động, tài sản tiếp thị cá nhân hóa và các công cụ trực quan hóa dữ liệu. Hãy thực hiện các bước này, thử nghiệm mạnh dạn và xem các ứng dụng của bạn tạo ra những hình ảnh có thể sánh ngang với các studio chuyên nghiệp.

Tải xuống Apidog ngay hôm nay và tăng tốc phát triển Nano Banana Pro của bạn — sự khác biệt về năng suất sẽ trở nên rõ ràng sau phiên làm việc đầu tiên của bạn.

button