Nano Banana

ID:google/nano-banana

API tạo hình ảnh Nano Banana của Google — mô hình giá rẻ chạy bằng Gemini 2.5 Flash với 11 tỷ lệ khung hình và tối đa 10 hình ảnh tham chiếu.

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

Tổng quan

API tạo hình ảnh Nano Banana của Google — mô hình giá rẻ chạy bằng Gemini 2.5 Flash với 11 tỷ lệ khung hình và tối đa 10 hình ảnh tham chiếu.

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",
    "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",
    "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:12:33:23:44:34:55:49:1616:921:9auto`
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	Requête invalide - paramètres manquants ou malformés
401	Échec de l'authentification - clé API manquante ou invalide
402	Crédits insuffisants
403	Interdit - IP non autorisée ou limite de crédits de la clé API dépassée
404	Exécution introuvable
429	Limite de requêtes dépassée
500	Erreur interne du serveur