API nano-banana-2 — Truy cập qua Gateway API AI

nano-banana-2 là mô hình ảnh Gemini của Google, mạnh cả về tạo ảnh lẫn chỉnh sửa ảnh, và đặc biệt xuất sắc ở khả năng ghép nhiều ảnh tham chiếu (tối đa 6 ảnh). Hãy gọi nó qua byesu — một gateway API AI với API ảnh tương thích OpenAI: yêu cầu được định tuyến đến mô hình chính hãng, không giảm chất lượng, tính phí theo từng ảnh ở mức $0.025 / ảnh, với độ phân giải trải rộng 1K / 2K / 4K. Cùng một nền tảng còn cung cấp các mô hình văn bản Claude, GPT-5.6, Grok và Gemini, trả theo mức dùng, không cần thuê bao.

Trang này cung cấp một ví dụ tích hợp bạn có thể sao chép và chạy ngay. Đăng ký bảng điều khiển tại byesu.com; tài liệu API media đầy đủ tại docs.byesu.com/vi/media.

Tóm tắt một câu: nó là gì và giá bao nhiêu

• Mô hình: nano-banana-2 (ảnh Google Gemini) — text-to-image và image-to-image trong một, nổi bật ở khả năng ghép nhiều ảnh tham chiếu
• Giá: $0.025 / ảnh, tính phí theo từng ảnh; các độ phân giải 1K / 2K / 4K đều được biểu diễn qua tham số size
• Cách kết nối: API tương thích OpenAI, Base URL https://byesu.com/v1, dùng token thuộc nhóm media / media-gen

Token phải chọn đúng nhóm

Token cho mô hình ảnh bắt buộc phải thuộc nhóm media / media-gen, nếu không bạn sẽ gặp lỗi "no available channel". Khi tạo token trong bảng điều khiển, chỉ cần chọn nhóm này trong danh sách thả xuống "Nhóm". Chi tiết xem Chọn nhóm.

Cách gọi

Chuẩn bị: lấy một token

1. Mở bảng điều khiển và đăng nhập → Token ở thanh bên trái → Thêm token
2. Đặt nhóm là media / media-gen, đặt tên, thiết lập hạn mức → gửi
3. Sao chép token thu được, có dạng sk-xxxxxxxx

Text-to-image (curl)

Text-to-image gọi POST /v1/images/generations và trả về đồng bộ ảnh PNG dưới dạng base64:

curl https://byesu.com/v1/images/generations \
  -H "Authorization: Bearer sk-token-của-bạn" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "một chú chó golden retriever chạy qua cánh đồng lúa mì vàng lúc hoàng hôn, phong cách điện ảnh, độ sâu trường ảnh nông",
    "size": "2048x1152"
  }'

Kết quả trả về:

{ "data": [ { "b64_json": "<base64 string>" } ] }

Text-to-image (Python)

import base64, requests

resp = requests.post(
    "https://byesu.com/v1/images/generations",
    headers={"Authorization": "Bearer sk-token-của-bạn"},
    json={
        "model": "nano-banana-2",
        "prompt": "đường phố cyberpunk trong đêm mưa, ánh đèn neon phản chiếu, ảnh chân thực 4K",
        "size": "3840x2160",   # cạnh dài ≈3840 → 4K
    },
).json()

b64 = resp["data"][0]["b64_json"]
open("out.png", "wb").write(base64.b64decode(b64))

Image-to-image / ghép nhiều ảnh tham chiếu (thế mạnh của nano-banana-2)

Image-to-image gọi POST /v1/images/edits với định dạng multipart/form-data. Ảnh tham chiếu được tải lên dưới dạng tệp, và tên trường image có thể lặp lại để gửi nhiều ảnh (nano-banana-2 tối đa 6 ảnh, mỗi ảnh ≤8MB):

curl https://byesu.com/v1/images/edits \
  -H "Authorization: Bearer sk-token-của-bạn" \
  -F model="nano-banana-2" \
  -F prompt="ghép những người trong ba bức ảnh này vào cùng một khung cảnh bờ biển với ánh sáng đồng nhất" \
  -F size="2048x2048" \
  -F image=@person1.png \
  -F image=@person2.png \
  -F image=@scene.png

Định dạng phản hồi giống với text-to-image (data[0].b64_json). Trong Python, gửi nhiều ảnh bằng files=[("image", open(p,"rb")) for p in paths].

Các tham số quan trọng

Tham số	Endpoint	Bắt buộc	Ghi chú
model	cả hai	✅	Luôn đặt là nano-banana-2; chữ hoa/thường và dấu gạch ngang phải khớp chính xác
prompt	cả hai	✅	Prompt văn bản; viết rõ chủ thể + bối cảnh + phong cách + ánh sáng sẽ cho kết quả tốt hơn
size	cả hai		Rộng x cao tính bằng pixel, quyết định đồng thời tỷ lệ khung hình và cấp độ phân giải: cạnh dài ≈1024 → 1K, ≈2048 → 2K, ≈3840 → 4K. Ví dụ "1024x1024" (1:1 · 1K), "2048x1152" (16:9 · 2K), "3840x2160" (16:9 · 4K). Nếu bỏ trống, mặc định là cấp cơ bản 1:1
image	chỉ edits		Trường tệp ảnh tham chiếu, có thể lặp lại để gửi nhiều ảnh; nano-banana-2 tối đa 6 ảnh, mỗi ảnh ≤8MB

Tính phí chỉ đếm theo "ảnh", không phụ thuộc cấp độ phân giải: $0.025 / ảnh. Bảng điều khiển hiển thị giá tính phí thực tế của từng lần gọi.

Vì sao dùng byesu để truy cập nano-banana-2

• Mô hình chính hãng, không giảm chất lượng: yêu cầu được định tuyến đến dịch vụ chính hãng — không reverse, không mirror, không crack — nên chất lượng đầu ra đồng nhất với dịch vụ chính hãng
• Giá theo ảnh minh bạch: nano-banana-2 ở mức $0.025 / ảnh; bảng điều khiển hiển thị giá tính phí thực tế bên cạnh giá niêm yết chính hãng, và bạn chỉ trả cho những gì đã dùng
• Tự động hoàn tiền khi thất bại: nếu tác vụ media tạo thất bại, chi phí được tự động hoàn lại — bạn không phải trả tiền cho ảnh hỏng
• Thân thiện với nhiều ảnh tham chiếu: hỗ trợ gốc việc tải nhiều ảnh qua /v1/images/edits, phát huy trực tiếp thế mạnh ghép tối đa 6 ảnh tham chiếu của nano-banana-2
• Một API, mọi mô hình: cùng một API tương thích OpenAI còn gọi được các mô hình ảnh / video / văn bản khác — đổi mô hình chỉ cần sửa trường model
• Trả theo mức dùng, không cần thuê bao: nạp tiền bằng USDT, Alipay hoặc WeChat Pay và chỉ trả cho những ảnh bạn tạo ra

Liên kết liên quan

• Tổng quan API media (API ảnh / video)
• Mô hình và tham số tạo ảnh
• Bắt đầu nhanh: kết nối trong 3 bước
• Chọn nhóm (bắt buộc đọc khi tạo token)
• Đăng ký bảng điều khiển / tạo token

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

Làm sao để có quyền truy cập API nano-banana-2?

Đăng ký tại bảng điều khiển byesu, tạo một token thuộc nhóm media / media-gen, rồi gọi nano-banana-2 qua các endpoint tương thích OpenAI /v1/images/generations và /v1/images/edits với Base URL https://byesu.com/v1. byesu là một gateway API AI — cùng một nền tảng còn cung cấp Claude, GPT-5.6, Grok và Gemini, tính phí trả theo mức dùng, không cần thuê bao.

API nano-banana-2 giá bao nhiêu mỗi ảnh?

byesu tính phí nano-banana-2 ở mức $0.025 mỗi ảnh, tính theo từng ảnh bất kể cấp độ phân giải (1K/2K/4K). Lần tạo thất bại được tự động hoàn tiền, và bảng điều khiển hiển thị giá tính phí thực tế của từng lần gọi.

Làm sao ghép nhiều ảnh tham chiếu với nano-banana-2?

Gọi POST /v1/images/edits (định dạng multipart) và đưa từng ảnh tham chiếu dưới dạng tệp vào trường image — trường này có thể lặp lại để tải lên nhiều ảnh. nano-banana-2 hỗ trợ tối đa 6 ảnh tham chiếu, mỗi ảnh ≤8MB — rất phù hợp để ghép nhiều nhân vật hoặc phần tử vào cùng một khung cảnh.

Có thể dùng nano-banana-2 trong Claude Code hay ứng dụng client không?

nano-banana-2 là mô hình tạo ảnh, được gọi qua các endpoint /v1/images/generations và /v1/images/edits chứ không qua API chat, nên nó không được dùng như một mô hình chat trong Claude Code. Bạn có thể gọi trực tiếp bằng curl/Python, hoặc chọn nó trong workbench tạo sinh của byesu. Các client như Claude Code, Codex và Cherry Studio kết nối với các mô hình văn bản/lập trình.

nano-banana-2 hỗ trợ những độ phân giải và tỷ lệ khung hình nào?

Hỗ trợ ba cấp — 1K / 2K / 4K — biểu diễn qua tham số size (rộng x cao tính bằng pixel): cạnh dài khoảng 1024 là 1K, khoảng 2048 là 2K, khoảng 3840 là 4K. Các tỷ lệ thường dùng gồm 1:1, 16:9, 9:16, 4:3 và 3:4 — ví dụ 2048x1152 là 16:9 ở cấp 2K.

Gọi nano-banana-2 báo lỗi "no available channel" thì xử lý thế nào?

Hầu như luôn do chọn sai nhóm token. Token cho mô hình ảnh phải thuộc nhóm media / media-gen. Hãy tạo một token mới thuộc nhóm đó trong bảng điều khiển, và đảm bảo trường model được đặt là nano-banana-2 (khớp chữ hoa/thường và dấu gạch ngang) — lỗi sẽ biến mất.