# API Z Image เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับการสร้าง text-to-image ด้วย Z Image ## รุ่นย่อยของโมเดล API นี้รองรับโมเดลหนึ่งรุ่นย่อย: | โมเดล | ID | คำอธิบาย | |-------|-----|-------------| | **Z Image** | `z-image` | การสร้าง text-to-image ที่รวดเร็ว | ## การเปรียบเทียบอย่างรวดเร็ว | ฟีเจอร์ | Z Image | |---------|---------| | อินพุต | prompt ข้อความ | | เอาต์พุต | รูปภาพที่สร้างหนึ่งรูป | | อัตราส่วนภาพ | รองรับหลายอัตราส่วน | | ความละเอียด | คำนวณจากค่ารatio ความกว้าง/ความสูง | | `seed` | ไม่บังคับ | ### อัตราส่วนภาพที่รองรับ คู่ `width:height` ต้องเป็นหนึ่งในรายการต่อไปนี้: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Text-to-Image) ### จุดปลายทาง ``` POST /api/v1/image/task ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"z-image"` | | `prompt` | string | prompt สำหรับสร้างรูปภาพ | | `width` | number | ค่ารatio ความกว้าง (เช่น `16` สำหรับ `16:9`) | | `height` | number | ค่ารatio ความสูง (เช่น `9` สำหรับ `16:9`) | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | คำอธิบาย | |-----------|------|-------------| | `seed` | number | seed สุ่มในช่วง `[0, 2147483647]` ใช้ `null` หรือ `0` สำหรับการสร้างแบบสุ่ม | ### ตัวอย่างคำขอ ```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: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## รูปแบบการตอบกลับ การตอบกลับเมื่อ submit: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Poll ด้วย `GET /api/v1/image/{task_id}` สถานะงาน: `submitted`, `processing`, `succeed`, `failed` การตอบกลับ polling ที่สำเร็จจะแสดง URL รูปภาพที่สร้างไว้ใน `data.task_result.images[].url` ## แนวทางปฏิบัติที่ดีที่สุด - ใช้ค่ารatio ไม่ใช่ขนาดพิกเซล สำหรับ `width` และ `height` - รักษา prompt ให้มีรายละเอียดแต่โฟกัสที่ตัวแบบ แสง และองค์ประกอบภาพ - ใช้ `seed` คงที่เมื่อคุณต้องการผลลัพธ์ที่ทำซ้ำได้ระหว่างการทดสอบ