Nano Banana API — giữ nguyên OpenAI SDK, giá mỗi ảnh và cách gọi

Nếu tìm API nano banana bằng tiếng Hàn, kết quả thường chia thành hai nhóm — tài liệu chính thức của Google hoặc bài blog “Cách nhận khóa từ AI Studio”. Điều thực sự cần thiết nằm ở giữa hai nhóm đó. Bài viết này trình bày cách gọi bằng OpenAI SDK hiện có và tổng hợp đơn giá mỗi ảnh của toàn bộ dòng mô hình trong một bảng. Không cần dự án Google Cloud.

Giá mỗi ảnh — toàn bộ dòng mô hình

Các mức giá bên dưới được đọc từ danh mục mô hình chứ không viết cố định trong bài. Khi giá thay đổi, bảng này cũng cập nhật theo.

Tất cả đều dựa trên per image và được trừ từ số dư trả trước thay vì thuê bao. Không có phí trong những tháng không tạo ảnh.

Gọi API — chỉ thay đổi base_url và tên mô hình

Nếu bạn đã dùng OpenAI SDK, không cần học thêm gì mới. Chỉ cần thay đổi hai chỗ trong phần khởi tạo client: base_url và tên mô hình.

# 기존 OpenAI SDK를 그대로 씁니다. base_url과 모델 이름만 바뀝니다.
# Google Cloud 프로젝트도, 별도 SDK 설치도 필요 없습니다.
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key=os.environ["KUNAVO_API_KEY"],
)

img = client.images.generate(
    model="nano-banana-2",
    prompt="한옥 마당에 눈이 내리는 장면, 따뜻한 조명, 사진 스타일",
    n=1,
)
print(img.data[0].url)

Endpoint là POST /v1/images/generations, có cùng định dạng với endpoint hình ảnh của OpenAI. Vì vậy, nếu mã của bạn đã tích hợp tạo ảnh, chỉ cần thay đổi một chuỗi tên mô hình để chuyển đổi.

Kiểm tra khóa trước khi bắt đầu

Trước khi sửa mã, hãy xác nhận khóa và địa chỉ bằng một yêu cầu. Khi phát sinh lỗi sau đó, bạn có thể thu hẹp nguyên nhân về phía mã.

# 키가 되는지 30초 만에 확인하는 최소 요청
curl -sS https://api.kunavo.com/v1/images/generations \
  -H "Authorization: Bearer sk-kn-..." \
  -H "content-type: application/json" \
  -d '{"model":"nano-banana","prompt":"a paper crane on a desk","n":1}'

401 là lỗi xác thực, 429 là giới hạn tốc độ và 529 là quá tải upstream. Bảng phân nhánh trong tổng hợp lỗi Claude Code cũng áp dụng nguyên như vậy.

Nên đặt cấp độ nào làm mặc định?

Cách hiệu quả nhất về chi phí là đặt mô hình cơ bản làm mặc định và chỉ nâng lên Pro cho những trường hợp kết quả chưa đạt. Vì chỉ cần thay đổi một chuỗi tên mô hình, hãy tận dụng việc chi phí thử nghiệm so sánh gần như bằng không — chạy cùng một prompt một lần ở mỗi cấp độ rồi quyết định.

Giá video có tại giá Veo 3; tài liệu chi tiết bằng tiếng Anh tại Nano Banana API. Phương thức thanh toán và đăng ký thẻ nội địa được trình bày tại giá và thanh toán Claude API.

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