# ChatGPT Images 2.6 API เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดล ChatGPT Images 2.6 Flare และ Sunburst ## รุ่นของโมเดล API นี้รองรับโมเดลสี่รุ่น: | โมเดล | ID | คำอธิบาย | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | สร้างภาพจากข้อความพร้อมการควบคุมความละเอียดและคุณภาพ | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | แก้ไขภาพและจัดองค์ประกอบจากหลายภาพ | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | สร้างภาพจากข้อความพร้อมการควบคุมความละเอียดและคุณภาพ | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | แก้ไขภาพและจัดองค์ประกอบจากหลายภาพ | ## เปรียบเทียบอย่างรวดเร็ว Flare และ Sunburst ใช้ตัวเลือกคำขอต่อไปนี้ร่วมกัน | คุณสมบัติ | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | ข้อมูลนำเข้า | พรอมต์ข้อความ | ภาพ + พรอมต์ข้อความ | | ตัวเลือกความละเอียด | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | ตัวเลือกคุณภาพ | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | คุณภาพเริ่มต้น | `medium` | `medium` | | อัตราส่วนภาพ | 10 ตัวเลือก | 10 ตัวเลือก | | ภาพนำเข้า | ไม่ต้องใช้ | จำเป็น (1–16 ภาพ) | | รูปแบบผลลัพธ์ | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | รูปแบบผลลัพธ์เริ่มต้น | `png` | `png` | ### อัตราส่วนภาพที่รองรับ `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 ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"gpt-image-2.6-flare"` | | `prompt` | string | พรอมต์สำหรับสร้างภาพ | | `width` | integer | ค่าสัดส่วนความกว้าง เช่น `16` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `height` | integer | ค่าสัดส่วนความสูง เช่น `9` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `resolution` | string | `"1k"`, `"2k"`, หรือ `"4k"` | อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น #### ไม่บังคับ | พารามิเตอร์ | ชนิด | ค่าเริ่มต้น | คำอธิบาย | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, หรือ `"max"` | | `output_format` | string | `"png"` | รูปแบบผลลัพธ์: `"png"`, `"jpeg"`, `"webp"`, `"gif"` หรือ `"svg"` ใช้ `"gif"` สำหรับภาพเคลื่อนไหว GIF หรือ `"svg"` สำหรับผลลัพธ์เวกเตอร์ SVG | | `frame_count` | integer | `9` | จำนวนเฟรม GIF ตั้งแต่ `2` ถึง `16` ใช้เฉพาะเมื่อ `output_format` เป็น `"gif"` | | `frame_duration_ms` | integer | `200` | ระยะเวลาต่อเฟรม GIF เป็นมิลลิวินาที ตั้งแต่ `20` ถึง `2000` ใช้เฉพาะเมื่อ `output_format` เป็น `"gif"` | ### ตัวอย่างคำขอ ```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: '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 ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"gpt-image-2.6-flare-edit"` | | `prompt` | string | คำอธิบายการแก้ไขที่ต้องการ | | `image_url_list` | string[] | URL ของภาพนำเข้า อย่างน้อย 1 ภาพและไม่เกิน 16 ภาพ โดยแต่ละภาพต้องมีขนาดน้อยกว่า 50 MB | | `width` | integer | ค่าสัดส่วนความกว้าง เช่น `16` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `height` | integer | ค่าสัดส่วนความสูง เช่น `9` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `resolution` | string | `"1k"`, `"2k"`, หรือ `"4k"` | อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น #### ไม่บังคับ | พารามิเตอร์ | ชนิด | ค่าเริ่มต้น | คำอธิบาย | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, หรือ `"max"` | | `output_format` | string | `"png"` | รูปแบบผลลัพธ์: `"png"`, `"jpeg"` หรือ `"webp"` | ### ตัวอย่างคำขอ ```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: '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 ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"gpt-image-2.6-sunburst"` | | `prompt` | string | พรอมต์สำหรับสร้างภาพ | | `width` | integer | ค่าสัดส่วนความกว้าง เช่น `16` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `height` | integer | ค่าสัดส่วนความสูง เช่น `9` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `resolution` | string | `"1k"`, `"2k"`, หรือ `"4k"` | อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น #### ไม่บังคับ | พารามิเตอร์ | ชนิด | ค่าเริ่มต้น | คำอธิบาย | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, หรือ `"max"` | | `output_format` | string | `"png"` | รูปแบบผลลัพธ์: `"png"`, `"jpeg"`, `"webp"`, `"gif"` หรือ `"svg"` ใช้ `"gif"` สำหรับภาพเคลื่อนไหว GIF หรือ `"svg"` สำหรับผลลัพธ์เวกเตอร์ SVG | | `frame_count` | integer | `9` | จำนวนเฟรม GIF ตั้งแต่ `2` ถึง `16` ใช้เฉพาะเมื่อ `output_format` เป็น `"gif"` | | `frame_duration_ms` | integer | `200` | ระยะเวลาต่อเฟรม GIF เป็นมิลลิวินาที ตั้งแต่ `20` ถึง `2000` ใช้เฉพาะเมื่อ `output_format` เป็น `"gif"` | ### ตัวอย่างคำขอ ```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: '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 ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | คำอธิบายการแก้ไขที่ต้องการ | | `image_url_list` | string[] | URL ของภาพนำเข้า อย่างน้อย 1 ภาพและไม่เกิน 16 ภาพ โดยแต่ละภาพต้องมีขนาดน้อยกว่า 50 MB | | `width` | integer | ค่าสัดส่วนความกว้าง เช่น `16` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `height` | integer | ค่าสัดส่วนความสูง เช่น `9` สำหรับ `16:9` ไม่ใช่ขนาดเป็นพิกเซล | | `resolution` | string | `"1k"`, `"2k"`, หรือ `"4k"` | อัตราส่วน width:height ต้องตรงกับหนึ่งในอัตราส่วนภาพที่รองรับซึ่งระบุไว้ข้างต้น #### ไม่บังคับ | พารามิเตอร์ | ชนิด | ค่าเริ่มต้น | คำอธิบาย | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, หรือ `"max"` | | `output_format` | string | `"png"` | รูปแบบผลลัพธ์: `"png"`, `"jpeg"` หรือ `"webp"` | ### ตัวอย่างคำขอ ```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: '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` สำหรับตรวจสอบสถานะเป็นระยะ: ```json { "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}` เป็นระยะเพื่อตรวจสอบสถานะ: ```json { "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` งานที่ส่งแล้วหรือกำลังประมวลผลอาจยังไม่มีภาพผลลัพธ์ ## แนวทางปฏิบัติที่แนะนำ 1. **ระบุองค์ประกอบภาพให้ชัดเจน**: ChatGPT Images 2.6 ให้ผลลัพธ์ดีที่สุดเมื่อพรอมต์อธิบายตัวแบบ การจัดกรอบภาพ แสง และสไตล์ที่ต้องการอย่างชัดเจน 2. **เลือกอัตราส่วนภาพให้เหมาะกับปลายทางการใช้งาน**: กำหนดอัตราส่วนล่วงหน้าสำหรับโพสต์โซเชียลมีเดีย แบนเนอร์ หน้าสินค้า หรือเลย์เอาต์งานบรรณาธิการ 3. **ใช้ภาพต้นฉบับที่ชัดเจนสำหรับการแก้ไข**: ภาพนำเข้าที่คมชัดและมีแสงเพียงพอช่วยรักษาเอกลักษณ์และเพิ่มคุณภาพการแก้ไขเฉพาะจุด 4. **ใช้เฉพาะภาพอ้างอิงที่เหมาะสมในคำขอหลายภาพ**: สำหรับคำขอแก้ไข ให้ส่งเฉพาะภาพที่สำคัญเพื่อหลีกเลี่ยงแนวทางภาพที่ขัดแย้งกัน