Hướng dẫn API Nano Banana: Tạo và chỉnh sửa hình ảnh thông qua TokenLab

API Nano Banana cung cấp cho các nhà phát triển khả năng tạo và chỉnh sửa hình ảnh với lưu lượng cao, có thể truy cập trực tiếp thông qua lớp API thống nhất của TokenLab. Hướng dẫn này trình bày cách xác thực, cấu trúc payload và tích hợp các quy trình tạo hình ảnh này vào các ứng dụng sản xuất của bạn.

Những điểm chính

• API Nano Banana chuyên về tạo hình ảnh nhanh và các tác vụ chỉnh sửa chính xác.
• TokenLab đơn giản hóa việc tích hợp bằng cách cung cấp một SDK duy nhất và thanh toán hợp nhất cho nhiều nhà cung cấp mô hình.
• Cấu trúc payload yêu cầu các thông số cụ thể về kích thước, định dạng prompt và độ mạnh để có kết quả tối ưu.
• Các nhà phát triển có thể so sánh hiệu suất và số liệu định giá của Nano Banana với các mô hình tiêu chuẩn ngành khác trực tiếp trên TokenLab.

API Nano Banana là gì?

API Nano Banana là một giao diện chuyên dụng được thiết kế để tạo và thao tác hình ảnh với độ trễ thấp. Nó phục vụ các nhà phát triển cần tạo mẫu nhanh và quy trình sản xuất có thể mở rộng mà không cần quản lý các mô hình khuếch tán tự lưu trữ. Bằng cách định tuyến các yêu cầu thông qua TokenLab, các nhà phát triển có thể truy cập mô hình này cùng với một bộ công cụ rộng lớn hơn.

Khi đánh giá API mô hình hình ảnh AI tốt nhất năm 2026, các nhà phát triển thường so sánh Nano Banana với các mô hình lớn hơn như Stable Diffusion XL hoặc Midjourney. Trong khi các mô hình đó cung cấp đầu ra có độ trung thực cao cho các prompt phức tạp, Nano Banana tập trung vào tốc độ thực thi và hiệu quả chi phí. Bạn có thể xem lại các thông số kỹ thuật và tính khả dụng của mô hình này trong danh mục mô hình TokenLab (quan sát ngày 07/07/2026).

Xác thực và thiết lập qua TokenLab

Để tương tác với API Nano Banana, bạn phải định tuyến các yêu cầu của mình thông qua cổng của TokenLab. Điều này yêu cầu một khóa API và một HTTP client tiêu chuẩn. Danh sách kiểm tra sau đây phác thảo các bước cần thiết để chuẩn bị môi trường phát triển của bạn.

Danh sách kiểm tra tích hợp

• Tạo tài khoản nhà phát triển đang hoạt động trên TokenLab.
• Tạo khóa API sản xuất từ bảng điều khiển TokenLab.
• Lưu khóa API dưới dạng biến môi trường có tên TOKENLAB_API_KEY.
• Cài đặt thư viện HTTP client như requests trong Python hoặc axios trong Node.js.
• Xác minh số dư tài khoản hoặc cấu hình thanh toán của bạn để đảm bảo các lệnh gọi API không bị gián đoạn.

Sau khi hoàn thành các bước này, hãy cấu hình client của bạn để trỏ đến endpoint của TokenLab. URL cơ sở cho tất cả các yêu cầu là https://api.tokenlab.sh/v1 và khóa API phải được truyền trong tiêu đề ủy quyền (authorization header).

# Ví dụ lệnh curl để xác minh xác thực
curl -X GET "https://api.tokenlab.sh/v1/models" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Triển khai tạo hình ảnh với API Nano Banana

Tạo văn bản thành hình ảnh (text-to-image) là điểm truy cập chính cho API Nano Banana. API chấp nhận một payload JSON chứa văn bản prompt, kích thước mong muốn và các tham số suy luận.

Để hiểu cách chi phí vận hành của Nano Banana so sánh với các mô hình khác, hãy tham khảo hướng dẫn so sánh giá của TokenLab. Vì giá mô hình có thể thay đổi dựa trên cập nhật của nhà cung cấp, người đọc nên xác minh giá hiện tại trên nguồn được liên kết.

Tập lệnh Python dưới đây minh họa cách gửi yêu cầu text-to-image đến API Nano Banana thông qua TokenLab.

import os
import requests
import json

def generate_image(prompt, width=512, height=512):
    api_key = os.getenv("TOKENLAB_API_KEY")
    if not api_key:
        raise ValueError("Biến môi trường TOKENLAB_API_KEY chưa được thiết lập.")

    url = "https://api.tokenlab.sh/v1/images/generations"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    
    payload = {
        "model": "nano-banana",
        "prompt": prompt,
        "width": width,
        "height": height,
        "num_inference_steps": 30,
        "guidance_scale": 7.5,
        "response_format": "url"
    }

    response = requests.post(url, headers=headers, json=payload)
    
    if response.status_code == 200:
        data = response.json()
        return data["data"][0]["url"]
    else:
        raise Exception(f"Lỗi API {response.status_code}: {response.text}")

# Ví dụ sử dụng
if __name__ == "__main__":
    prompt_text = "Một bức chân dung studio tối giản của một chiếc bình gốm trên bàn gỗ"
    try:
        image_url = generate_image(prompt_text)
        print(f"URL hình ảnh đã tạo: {image_url}")
    except Exception as e:
        print(f"Tạo hình ảnh thất bại: {e}")

Khi cấu trúc các prompt của bạn, hãy sử dụng các danh từ cụ thể, mang tính mô tả. API Nano Banana xử lý trọng số prompt theo trình tự, nghĩa là các thuật ngữ đặt ở đầu prompt sẽ có ảnh hưởng mạnh hơn đến kết quả cuối cùng so với các thuật ngữ đặt ở cuối.

Quy trình chỉnh sửa hình ảnh và Inpainting

Ngoài việc tạo văn bản thành hình ảnh tiêu chuẩn, API Nano Banana hỗ trợ các sửa đổi hình ảnh thành hình ảnh (image-to-image) và inpainting cục bộ. Các quy trình này yêu cầu một hình ảnh nguồn ban đầu và, trong trường hợp inpainting, một mặt nạ đen trắng chỉ ra vùng cần sửa đổi.

Để thực hiện tác vụ image-to-image, bạn phải cung cấp hình ảnh nguồn dưới dạng chuỗi mã hóa base64 hoặc URL có thể truy cập công khai. Tham số strength xác định mức độ mô hình thay đổi hình ảnh gốc. Giá trị strength là 0.0 giữ nguyên hình ảnh nguồn, trong khi giá trị 1.0 loại bỏ hoàn toàn cấu trúc gốc để ưu tiên cho prompt mới.

# Cấu trúc payload khái niệm cho chỉnh sửa image-to-image
edit_payload = {
    "model": "nano-banana",
    "prompt": "Thêm bầu trời xanh với những đám mây trắng mềm mại",
    "image": "data:image/jpeg;base64,...", # Hình ảnh nguồn đã mã hóa Base64
    "strength": 0.6,
    "guidance_scale": 8.0
}

Đối với các tác vụ inpainting, hình ảnh mặt nạ phải khớp với kích thước của hình ảnh nguồn. Các pixel màu trắng trong mặt nạ đại diện cho các khu vực cần vẽ lại, trong khi các pixel màu đen vẫn được giữ nguyên. Cách tiếp cận này cực kỳ hiệu quả cho các ứng dụng thương mại điện tử, chẳng hạn như thay đổi nền của ảnh sản phẩm trong khi vẫn giữ nguyên sản phẩm.

Để bắt đầu tích hợp mô hình này vào stack của bạn, hãy Bắt đầu với TokenLab ngay hôm nay.

So sánh Nano Banana với các API thay thế

Việc chọn đúng mô hình phụ thuộc vào các yêu cầu cụ thể của ứng dụng về độ trễ, chất lượng đầu ra và chi phí. Bảng dưới đây so sánh API Nano Banana với các mô hình nổi bật khác có sẵn trong ngành.

Mô hình / API	Trường hợp sử dụng chính	Điểm mạnh chính	Nguồn tham khảo giá
API Nano Banana	Tạo & chỉnh sửa hình ảnh nhanh	Độ trễ thấp, cấu trúc payload đơn giản	Mô hình TokenLab (quan sát ngày 07/07/2026)
Google Gemini (Imagen)	Tác vụ đa phương thức & tạo độ phân giải cao	Bảo mật doanh nghiệp, tích hợp hệ sinh thái Google	Giá Google AI (quan sát ngày 07/07/2026)
Stable Diffusion	Tạo hình ảnh tùy biến cao	Tính linh hoạt mã nguồn mở, hỗ trợ LoRA tùy chỉnh	Danh mục hình ảnh TokenLab

Đối với các nhà phát triển xây dựng hệ thống phức tạp, việc so sánh các bộ định tuyến API cũng là một bước quan trọng. Bạn có thể đọc so sánh OpenRouter của chúng tôi để hiểu cách các cổng API đa nhà cung cấp quản lý định tuyến và chuyển đổi dự phòng.

Nếu ứng dụng của bạn yêu cầu các khả năng vượt ra ngoài hình ảnh tĩnh, bạn có thể muốn xem lại API mô hình video AI tốt nhất năm 2026 hoặc khám phá các mô hình AI tốt nhất cho lập trình năm 2026 để hỗ trợ quy trình phát triển của bạn.

So sánh các mô hình hình ảnh trên TokenLab để tìm sự cân bằng tối ưu giữa tốc độ, chi phí và chất lượng cho ứng dụng của bạn.

Câu hỏi thường gặp

Độ phân giải tối đa được hỗ trợ bởi API Nano Banana là bao nhiêu?

API Nano Banana hỗ trợ độ phân giải gốc lên đến 1024x1024 pixel. Mặc dù bạn có thể yêu cầu các tỷ lệ khung hình không vuông như 16:9 hoặc 4:3, việc giữ tổng số pixel gần với độ phân giải gốc sẽ giúp ngăn ngừa các lỗi hình ảnh như chủ thể bị lặp lại.

TokenLab xử lý giới hạn tốc độ (rate limits) cho API Nano Banana như thế nào?

TokenLab quản lý giới hạn tốc độ một cách linh hoạt dựa trên cấp độ tài khoản của bạn. Nếu ứng dụng của bạn vượt quá số lượng yêu cầu cho phép mỗi phút, API sẽ trả về mã trạng thái 429 Too Many Requests. Việc triển khai cơ chế exponential backoff trong HTTP client của bạn được khuyến nghị để xử lý các giới hạn này một cách ổn định.

Tôi có thể sử dụng Nano Banana cho các ứng dụng thương mại không?

Có, hình ảnh được tạo thông qua API Nano Banana qua TokenLab thường được cấp phép cho mục đích thương mại. Tuy nhiên, các nhà phát triển phải đảm bảo rằng các prompt đầu vào và hình ảnh nguồn của họ không vi phạm quyền sở hữu trí tuệ của bên thứ ba hoặc các chính sách sử dụng được chấp nhận của nền tảng.