Nano Banana 2

ID:google/nano-banana-2

API tạo hình ảnh Nano Banana 2 của Google — Gemini 3.1 Flash với đầu ra 4K, 15 tỷ lệ khung hình, và nhất quán nhân vật cho tối đa 5 nhân vật.

Chuyển văn bản thành hình ảnhChỉnh sửa hình ảnhHình ảnh tham chiếu4KHiển thị văn bản

Tổng quan

API tạo hình ảnh Nano Banana 2 của Google — Gemini 3.1 Flash với đầu ra 4K, 15 tỷ lệ khung hình, và nhất quán nhân vật cho tối đa 5 nhân vật.

Xác thực

Tất cả request API yêu cầu khóa API hợp lệ được truyền qua header Authorization sử dụng scheme Bearer.

Bắt đầu nhanh

Thông tin xác thực

Đặt biến môi trường RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Tạo lượt chạy

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Lượt chạy

Các lượt chạy được xử lý bất đồng bộ. Gửi request, sau đó poll để lấy kết quả.

Tạo lượt chạy

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Lấy trạng thái lượt chạy

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Lấy kết quả

Poll endpoint trạng thái cho đến khi status là "succeeded", sau đó đọc output.urls từ response.

Schema đầu vào

Tham số	Loại	Bắt buộc	Mô tả
prompt	string	Bắt buộc	Prompt
aspect_ratio	string	Tùy chọn	Aspect ratioTùy chọn: `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	Tùy chọn	ResolutionTùy chọn: `1K2K4K`
image_urls	string[]	Tùy chọn	Reference images

Schema đầu ra

Trường	Loại	Mô tả
urls	string[]	URL đầu ra đã tạo

Lỗi

API sử dụng mã trạng thái HTTP tiêu chuẩn để biểu thị thành công hoặc thất bại.

Mã trạng thái	Mô tả
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ