เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดล ChatGPT Images 2.6 Flare และ Sunburst
รุ่นของโมเดล {#}
API นี้รองรับโมเดลสี่รุ่น:
เปรียบเทียบอย่างรวดเร็ว
Flare และ Sunburst ใช้ตัวเลือกคำขอต่อไปนี้ร่วมกัน
อัตราส่วนภาพที่รองรับ
16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9
ChatGPT Images 2.6 Flare (สร้างภาพจากข้อความ)
เอนด์พอยต์
POST /api/v1/image/task
การยืนยันตัวตน
Authorization: Bearer YOUR_API_KEY
พารามิเตอร์คำขอ
จำเป็น
อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น
ไม่บังคับ
ตัวอย่างคำขอ
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: 'gpt-image-2.6-flare',
prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting',
width: 1,
height: 1,
resolution: '1k',
quality: 'medium',
output_format: 'gif',
frame_count: 9,
frame_duration_ms: 200
})
});
const { data } = await response.json();
const taskId = data.task_id;
ChatGPT Images 2.6 Flare Edit (แก้ไขภาพ)
เอนด์พอยต์
POST /api/v1/image/task
พารามิเตอร์คำขอ
จำเป็น
อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น
ไม่บังคับ
ตัวอย่างคำขอ
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: 'gpt-image-2.6-flare-edit',
prompt: 'Replace the background with a warm studio setting while keeping the product unchanged',
image_url_list: ['https://example.com/product-photo.jpg'],
width: 1,
height: 1,
resolution: '1k',
quality: 'medium',
output_format: 'png'
})
});
const { data } = await response.json();
const taskId = data.task_id;
ChatGPT Images 2.6 Sunburst (สร้างภาพจากข้อความ)
เอนด์พอยต์
POST /api/v1/image/task
พารามิเตอร์คำขอ
จำเป็น
อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น
ไม่บังคับ
ตัวอย่างคำขอ
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: 'gpt-image-2.6-sunburst',
prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting',
width: 1,
height: 1,
resolution: '1k',
quality: 'medium',
output_format: 'gif',
frame_count: 9,
frame_duration_ms: 200
})
});
const { data } = await response.json();
const taskId = data.task_id;
ChatGPT Images 2.6 Sunburst Edit (แก้ไขภาพ)
เอนด์พอยต์
POST /api/v1/image/task
พารามิเตอร์คำขอ
จำเป็น
อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น
ไม่บังคับ
ตัวอย่างคำขอ
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: 'gpt-image-2.6-sunburst-edit',
prompt: 'Replace the background with a warm studio setting while keeping the product unchanged',
image_url_list: ['https://example.com/product-photo.jpg'],
width: 1,
height: 1,
resolution: '1k',
quality: 'medium',
output_format: 'png'
})
});
const { data } = await response.json();
const taskId = data.task_id;
รูปแบบการตอบกลับ
การตอบกลับเริ่มต้น
ChatGPT Images 2.6 ทั้งสี่รุ่นจะส่งคืน task_id สำหรับตรวจสอบสถานะเป็นระยะ:
{
"code": 0,
"data": {
"task_id": "{task_id}",
"task_status": "submitted",
"response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
},
"message": "success"
}
การตอบกลับเมื่อตรวจสอบสถานะ
เรียก GET /api/v1/image/{task_id} เป็นระยะเพื่อตรวจสอบสถานะ:
{
"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"
}
ค่าสถานะ
submitted: รับงานแล้ว
processing: กำลังสร้างหรือแก้ไขภาพ
succeed: งานเสร็จสมบูรณ์
failed: งานล้มเหลว
ระยะเวลาประมวลผล
ระยะเวลาประมวลผลแตกต่างกันตามโมเดล การตั้งค่าผลลัพธ์ ความซับซ้อนของพรอมต์ และจำนวนภาพอ้างอิง ตรวจสอบสถานะเป็นระยะจนกว่าสถานะงานจะเป็น succeed หรือ failed งานที่ส่งแล้วหรือกำลังประมวลผลอาจยังไม่มีภาพผลลัพธ์
แนวทางปฏิบัติที่แนะนำ
- ระบุองค์ประกอบภาพให้ชัดเจน: ChatGPT Images 2.6 ให้ผลลัพธ์ดีที่สุดเมื่อพรอมต์อธิบายตัวแบบ การจัดกรอบภาพ แสง และสไตล์ที่ต้องการอย่างชัดเจน
- เลือกอัตราส่วนภาพให้เหมาะกับปลายทางการใช้งาน: กำหนดอัตราส่วนล่วงหน้าสำหรับโพสต์โซเชียลมีเดีย แบนเนอร์ หน้าสินค้า หรือเลย์เอาต์งานบรรณาธิการ
- ใช้ภาพต้นฉบับที่ชัดเจนสำหรับการแก้ไข: ภาพนำเข้าที่คมชัดและมีแสงเพียงพอช่วยรักษาเอกลักษณ์และเพิ่มคุณภาพการแก้ไขเฉพาะจุด
- ใช้เฉพาะภาพอ้างอิงที่เหมาะสมในคำขอหลายภาพ: สำหรับคำขอแก้ไข ให้ส่งเฉพาะภาพที่สำคัญเพื่อหลีกเลี่ยงแนวทางภาพที่ขัดแย้งกัน