API Nano Banana Pro

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

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 Pro (Văn Bản Sang Ảnh)

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-pro',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k'
  })
});

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

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

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

Endpoint

POST /api/v1/image/task

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ụ Chỉnh Sửa Một Ảnh

javascriptSao chép
{
  model_name: 'nano-banana-pro-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-pro-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

Cả hai mô hình đều trả về task_id để kiểm tra trạng thái:

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

Phản Hồi Khi Kiểm Tra Trạng Thái

Gọi /api/v1/image/{taskId} để kiểm tra trạng thái:

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

Các Giá Trị Trạng Thái

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

Xử Lý Lỗi

Các Lỗi Thường Gặp

Độ Phân Giải Không Hợp Lệ

jsonSao chép
{
  "code": 400,
  "message": "Resolution must be one of: 1k, 2k, 4k"
}

Tỷ Lệ Khung Hình Không Hợp Lệ

jsonSao chép
{
  "code": 400,
  "message": "Ratio must be one of: 16:9, 9:16, 1:1, 3:2, 2:3, 4:3, 3:4, 4:5, 5:4, 21:9, 9:21"
}

Thiếu URL Ảnh (Chế Độ Chỉnh Sửa)

jsonSao chép
{
  "code": 400,
  "message": "image_url_list is required for nano-banana-pro-edit"
}

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

Mẹo Tạo Ảnh Từ Văn Bản

1. Cụ Thể Rõ Ràng: Bao gồm chủ thể, phong cách, ánh sáng, chi tiết 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í, sử dụng 4K cho chất lượng cao nhất
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 di động)
4. Chất Lượng Prompt: Prompt chi tiết hơn thường tạo ra kết quả tốt hơn

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 14 ả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

Ví Dụ Trường Hợp Sử Dụng

Chụp Ảnh Sản Phẩm

javascriptSao chép
{
  model_name: 'nano-banana-pro',
  prompt: 'Professional product shot of luxury watch on marble surface',
  width: 4,
  height: 3,
  resolution: '4k'
}

Ghép Nhiều Ảnh

javascriptSao chép
{
  model_name: 'nano-banana-pro-edit',
  image_url_list: [
    'photo1.jpg',
    'photo2.jpg',
    'photo3.jpg'
  ],
  prompt: 'Create a seamless collage with these vacation photos',
  width: 16,
  height: 9,
  resolution: '2k'
}

Nâng Cao Chất Lượng Ảnh

javascriptSao chép
{
  model_name: 'nano-banana-pro-edit',
  image_url_list: ['photo.jpg'],
  prompt: 'Enhance colors and add dramatic lighting',
  width: 1,
  height: 1,
  resolution: '2k'
}