API Nano Banana 2.1

Tài liệu tham khảo API đầy đủ cho các mô hình tạo ảnh từ văn bản và chỉnh sửa ảnh Nano Banana 2.1.

Các biến thể mô hình

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

So sánh nhanh

Các tỷ lệ khung hình được hỗ trợ

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

• 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

Cung cấp tỷ lệ bằng các giá trị số riêng biệt cho width và height; ví dụ, width: 16 và height: 9 chọn tỷ lệ 16:9. Các giá trị này biểu thị tỷ lệ, không phải kích thước đầu ra tính bằng pixel.

Nano Banana 2.1 (Tạo ảnh từ văn bản)

Điểm cuối

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 tỷ lệ sau: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1.

Tùy chọn

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

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

Nano Banana 2.1 Edit (Chỉnh sửa ảnh)

Điểm cuối

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 14 tỷ lệ được hỗ trợ liệt kê ở trên.

Tùy chọn

Ví dụ chỉnh sửa một ảnh

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

Ví dụ kết hợp nhiều ảnh

javascriptSao chép
{
  model_name: 'nano-banana-2.1-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'],
  enable_web_search: false,
  enable_image_search: false
}

Lưu ý về tính phí: Ảnh tham chiếu được tính phí theo từng ảnh, bắt đầu từ ảnh đầu tiên. Mỗi tùy chọn tìm kiếm được bật sẽ thêm một khoản phí cố định riêng cho mỗi lần tạo, bất kể số lượng ảnh. Xem bảng giá hiện tại để biết mức phí.

Đị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 khi kiểm tra trạng thái định kỳ

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.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

Các 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

Các phương pháp thực hành tốt nhất

Mẹo tạo ảnh từ văn bản

1. Mô tả ảnh: Đưa chủ thể, ánh sáng và bố cục vào câu lệnh.
2. Chọn độ phân giải: Truyền 1k, 2k hoặc 4k trong mỗi yêu cầu.
3. Chọn tỷ lệ khung hình: Truyền các giá trị width và height tương ứng với một trong 14 tỷ lệ được hỗ trợ.
4. Chọn tùy chọn tìm kiếm: Bỏ qua cờ tìm kiếm tương ứng để dùng giá trị mặc định false; đặt thành true khi cần.

Mẹo chỉnh sửa ảnh

1. Cung cấp ảnh tham chiếu: Đưa từ 1 đến 14 URL ảnh có thể truy cập vào image_url_list.
2. Mô tả chỉnh sửa: Nêu rõ trong câu lệnh những gì cần thay đổi hoặc giữ nguyên.
3. Chọn cài đặt đầu ra: Cung cấp các giá trị bắt buộc cho resolution, width và height.
4. Chọn tùy chọn tìm kiếm: Có thể bật tìm kiếm trên web và tìm kiếm hình ảnh độc lập với nhau.