Nano Banana 2 API

Tài liệu API đầy đủ cho các mô hình Nano Banana 2 được hỗ trợ bởi Google Gemini 3.1 Flash Image.

Các Biến Thể Mô Hình

API này hỗ trợ hai biến thể mô hình:

So Sánh Nhanh

Tỷ Lệ Khung Hình Được Hỗ Trợ

Cả hai mô hình đều hỗ trợ 11 tỷ lệ khung hình:

• 16:9 (mặc định), 9:16, 1:1, 3:2, 2:3, 4:3, 3:4, 4:5, 5:4, 21:9, 9:21

Nano Banana 2 (Text-to-Image)

Endpoint

POST /api/v1/image/task

Xác Thực

Authorization: Bearer YOUR_API_KEY

Tham Số Yêu Cầu

Bắt Buộc

Lưu ý: Tỷ lệ width:height phải là một trong các giá trị: "21:9", "9:21", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "1:1"

Ví Dụ Yêu Cầu

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'nano-banana-2',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Nano Banana 2 Edit (Chỉnh Sửa Ảnh)

Endpoint

POST /api/v1/image/task

Tham Số Yêu Cầu

Bắt Buộc

Ví Dụ Chỉnh Sửa Một Ảnh

javascriptSao chép
{
  model_name: 'nano-banana-2-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg']
}

Ví Dụ Kết Hợp Nhiều Ảnh

javascriptSao chép
{
  model_name: 'nano-banana-2-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg']
}

Định Dạng Phản Hồi

Phản Hồi Ban Đầu

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

Phản Hồi Polling

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

Phản Hồi Thành Công

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.0997,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  }
}

Giá Trị Trạng Thái

• submitted: Tác vụ đã được chấp nhận
• processing: Tác vụ đang chạy
• succeed: Tác vụ đã hoàn tất thành công
• failed: Tác vụ thất bại

Thực Hành Tốt Nhất

Mẹo Text-to-Image

1. Cụ Thể Rõ Ràng: Bao gồm chi tiết về chủ thể, phong cách, ánh sáng, bố cục
2. Chọn Độ Phân Giải Khôn Ngoan: 2K là mặc định và tiết kiệm chi phí
3. Lựa Chọn Tỷ Lệ Khung Hình: Chọn tỷ lệ dựa trên mục đích sử dụng (16:9 cho web, 9:16 cho mobile)
4. Chất Lượng Prompt: Prompt chi tiết hơn thường tạo ra kết quả tốt hơn
5. Lặp Lại Nhanh: Tốc độ của Nano Banana 2 lý tưởng cho việc tạo mẫu nhanh

Mẹo Chỉnh Sửa Ảnh

1. Hướng Dẫn Rõ Ràng: Cụ thể về những gì cần thay đổi
2. Kết Hợp Nhiều Ảnh: Có thể kết hợp tối đa 10 ảnh trong một yêu cầu
3. Khớp Độ Phân Giải: Độ phân giải đầu ra có thể khác với đầu vào
4. Hướng Dẫn Prompt: Mô tả kết quả mong muốn, không chỉ các thay đổi

Ưu Điểm Chính

• Tiết Kiệm Chi Phí: Chi phí thấp hơn tới 50% so với Nano Banana Pro
• Cực Nhanh: Tối ưu hóa cho việc tạo và lặp lại nhanh chóng
• Chất Lượng Cao: Duy trì chất lượng đầu ra chuyên nghiệp lên đến 4K
• Linh Hoạt: Hỗ trợ cùng tỷ lệ khung hình và tính năng như phiên bản Pro