Nano Banana 2.1

ID:google/nano-banana-2.1

API tạo ảnh Nano Banana 2.1 của Google — model ảnh Gemini Flash được nâng cấp về thiết kế hình ảnh, chỉnh sửa và tính nhất quán của chủ thể, tối đa 4K với 14 ảnh tham chiếu.

Nano Banana 2.1Gemini ImageGoogleChỉnh sửa ảnh4K

Tổng quan

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.1",
    "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.1",
    "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	无效请求 - 参数缺失或格式错误
401	认证失败 - API 密钥缺失或无效
402	额度不足
403	禁止访问 - IP 不在白名单、账号被封禁或 API 密钥消费限额已超出
404	未找到运行记录
429	请求频率超限
500	服务器内部错误