Nano Banana 2.1 API

เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างภาพจากข้อความและแก้ไขภาพ Nano Banana 2.1

รุ่นของโมเดล {#}

API นี้รองรับโมเดลสองรุ่น:

เปรียบเทียบโดยสรุป

อัตราส่วนภาพที่รองรับ

ทั้งสองโมเดลรองรับอัตราส่วนภาพ 14 แบบ:

• 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

ระบุอัตราส่วนโดยส่งค่าตัวเลข width และ height แยกกัน เช่น width: 16 และ height: 9 จะเลือก 16:9 ค่าเหล่านี้ระบุอัตราส่วน ไม่ใช่ขนาดพิกเซลของภาพผลลัพธ์

Nano Banana 2.1 (การสร้างภาพจากข้อความ)

จุดเชื่อมต่อ

POST /api/v1/image/task

การยืนยันตัวตน

Authorization: Bearer YOUR_API_KEY

พารามิเตอร์คำขอ

จำเป็น

หมายเหตุ: อัตราส่วน width:height ต้องเป็นหนึ่งในค่าต่อไปนี้: 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

ไม่บังคับ

ตัวอย่างคำขอ

javascriptคัดลอก
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 (การแก้ไขภาพ)

จุดเชื่อมต่อ

POST /api/v1/image/task

พารามิเตอร์คำขอ

จำเป็น

หมายเหตุ: อัตราส่วน width:height ต้องเป็นหนึ่งในอัตราส่วนที่รองรับทั้ง 14 แบบที่ระบุไว้ข้างต้น

ไม่บังคับ

ตัวอย่างการแก้ไขภาพเดียว

javascriptคัดลอก
{
  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
}

ตัวอย่างการรวมหลายภาพ

javascriptคัดลอก
{
  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
}

หมายเหตุการคิดค่าบริการ: ภาพอ้างอิงคิดค่าบริการต่อภาพตั้งแต่ภาพแรก ตัวเลือกการค้นหาแต่ละรายการที่เปิดใช้จะมีค่าบริการคงที่แยกต่างหากต่อการสร้างแต่ละครั้ง โดยไม่ขึ้นอยู่กับจำนวนภาพ ดูอัตราค่าบริการได้จากราคาปัจจุบัน

รูปแบบการตอบกลับ

การตอบกลับเริ่มต้น

jsonคัดลอก
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

การตอบกลับจากการตรวจสอบสถานะเป็นระยะ

jsonคัดลอก
{
  "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
  }
}

การตอบกลับเมื่อสำเร็จ

jsonคัดลอก
{
  "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"
        }
      ]
    }
  }
}

ค่าสถานะ

• submitted: รับงานแล้ว
• processing: กำลังประมวลผลงาน
• succeed: งานเสร็จสมบูรณ์แล้ว
• failed: งานล้มเหลว

แนวทางปฏิบัติที่แนะนำ

เคล็ดลับการสร้างภาพจากข้อความ

1. บรรยายภาพ: ระบุสิ่งหลักในภาพ แสง และองค์ประกอบภาพในพรอมต์
2. เลือกความละเอียด: ส่งค่า 1k, 2k หรือ 4k ในทุกคำขอ
3. เลือกอัตราส่วนภาพ: ส่งค่า width และ height ที่ตรงกับหนึ่งในอัตราส่วนที่รองรับทั้ง 14 แบบ
4. เลือกตัวเลือกการค้นหา: หากละแฟล็กการค้นหารายการใดไว้ รายการนั้นจะใช้ค่าเริ่มต้น false ตั้งค่าเป็น true เมื่อต้องการใช้งาน

เคล็ดลับการแก้ไขภาพ

1. ระบุภาพอ้างอิง: ใส่ URL ภาพที่เข้าถึงได้ 1 ถึง 14 รายการใน image_url_list
2. อธิบายการแก้ไข: ระบุสิ่งที่ควรเปลี่ยนแปลงหรือคงไว้ในพรอมต์
3. เลือกการตั้งค่าผลลัพธ์: ระบุค่า resolution, width และ height ที่จำเป็น
4. เลือกตัวเลือกการค้นหา: สามารถเปิดการค้นหาเว็บและการค้นหารูปภาพแยกกันได้