# API Pixverse V6 เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Pixverse V6 ทุกตัวแปรใช้ endpoint งานวิดีโอแบบรวมเดียวกัน ## ตัวแปรของโมเดล | โมเดล | ID | คำอธิบาย | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | สร้างวิดีโอจากพรอมต์ข้อความ | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | ทำแอนิเมชันจากภาพเฟรมแรกเพียงภาพเดียว | | **Pixverse V6 Transition** | `pixverse-v6-transition` | สร้างทรานซิชันระหว่างภาพเฟรมแรกและภาพเฟรมสุดท้าย | | **Pixverse V6 Extend** | `pixverse-v6-extend` | ขยายวิดีโอที่มีอยู่ด้วยเฟรมใหม่ซึ่งนำทางโดย `prompt` | ## เปรียบเทียบอย่างรวดเร็ว | ฟีเจอร์ | Text to Video | Image to Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | จำเป็น | จำเป็น | จำเป็น | จำเป็น | | `aspect_ratio` | ไม่บังคับ (ค่าเริ่มต้น `16:9`); ดูอัตราส่วนที่รองรับด้านล่าง | ไม่ใช้ (ตามภาพอินพุต) | ไม่ใช้ (ตามภาพอินพุต) | ไม่ใช้ (ตามวิดีโออินพุต) | | `image_url` | — | จำเป็น | จำเป็น (เฟรมแรก) | — | | `image_end_url` | — | — | จำเป็น (เฟรมสุดท้าย) | — | | `video_url` | — | — | — | จำเป็น (วิดีโอต้นทาง) | | `negative_prompt` | — | — | ไม่บังคับ | ไม่บังคับ | | `seed` | — | — | ไม่บังคับ (`0` ถือเป็นค่าเริ่มต้นของผลิตภัณฑ์) | ไม่บังคับ | | ระยะเวลา | 1–15 วินาที | 1–15 วินาที | 1–15 วินาที | 1–15 วินาที | | ความละเอียด | `360p`, `540p`, `720p`, `1080p` | เหมือนกัน | เหมือนกัน | เหมือนกัน | | เสียง | ไม่บังคับผ่าน `sound` | ไม่บังคับผ่าน `sound` | ไม่บังคับผ่าน `sound` | ไม่บังคับผ่าน `sound` | โมเดล text-to-video รองรับอัตราส่วนภาพ: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-v6-text-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ | | `duration` | integer | ความยาววิดีโอเป็นวินาที (`1`–`15`) | | `resolution` | string | หนึ่งใน `360p`, `540p`, `720p`, `1080p` | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `aspect_ratio` | string | ค่าเริ่มต้น `16:9` หนึ่งใน `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | ระบุว่าจะสร้างเสียงสำหรับวิดีโอหรือไม่ | ### ตัวอย่างคำขอ ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-text-to-video', prompt: 'A cinematic street scene at night with neon reflections', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Image to Video ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-v6-image-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ | | `duration` | integer | ความยาววิดีโอเป็นวินาที (`1`–`15`) | | `resolution` | string | หนึ่งใน `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL ของภาพเฟรมแรก | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `sound` | boolean | ระบุว่าจะสร้างเสียงสำหรับวิดีโอหรือไม่ | ### ตัวอย่างคำขอ ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-image-to-video', prompt: 'Fluid camera pan; maintain subject identity', duration: 6, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Transition สร้างการเคลื่อนไหวระหว่างภาพ keyframe **แรก** และ **สุดท้าย** รองรับ negative prompting และ seeding แบบไม่บังคับ. ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-v6-transition"` | | `prompt` | string | อธิบายการเคลื่อนไหวระหว่างสองเฟรม | | `duration` | integer | ความยาววิดีโอเป็นวินาที (`1`–`15`) | | `resolution` | string | หนึ่งใน `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL ของภาพเฟรมแรก | | `image_end_url` | string | URL ของภาพเฟรมสุดท้าย | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `sound` | boolean | ระบุว่าจะสร้างเสียงสำหรับวิดีโอหรือไม่ | | `negative_prompt` | string | เนื้อหาที่ต้องการลดการปรากฏในเอาต์พุต | | `seed` | integer | seed สำหรับความสุ่ม; `0` จะใช้พฤติกรรมสุ่มเริ่มต้นของแพลตฟอร์ม | ### ตัวอย่างคำขอ ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-transition', prompt: 'Seamless blend with natural lighting continuity', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, negative_prompt: 'blur, watermark, text overlay', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Extend ต่อคลิปที่มีอยู่ ให้ URL วิดีโอต้นทางและพรอมต์ที่อธิบายว่าเรื่องราวควรดำเนินต่ออย่างไร. ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-v6-extend"` | | `prompt` | string | อธิบายว่าวิดีโอควรดำเนินต่ออย่างไร | | `duration` | integer | ความยาววิดีโอเป็นวินาที (`1`–`15`) | | `resolution` | string | หนึ่งใน `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | URL ของวิดีโอต้นทางที่จะขยาย | #### ไม่บังคับ | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `sound` | boolean | ระบุว่าจะสร้างเสียงสำหรับวิดีโอหรือไม่ | | `negative_prompt` | string | เนื้อหาที่ต้องการลดการปรากฏในเอาต์พุต | | `seed` | integer | seed สำหรับความสุ่ม; `0` จะใช้พฤติกรรมสุ่มเริ่มต้นของแพลตฟอร์ม | ### ตัวอย่างคำขอ ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-extend', prompt: 'Continue the walk into the forest clearing', duration: 5, resolution: '720p', video_url: 'https://example.com/source-clip.mp4', sound: false, negative_prompt: 'low quality, jitter', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## รูปแบบการตอบกลับ ### การตอบกลับเริ่มต้น ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### การตอบกลับจากการ Polling Poll `GET /api/v1/video/{taskId}` เพื่อตรวจสอบสถานะ: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### ค่าสถานะ - `submitted`: งานได้รับการยอมรับและรอการประมวลผล - `processing`: กำลังสร้างวิดีโอ - `succeed`: สร้างวิดีโอเสร็จสมบูรณ์ - `failed`: สร้างวิดีโอล้มเหลว ## แนวทางปฏิบัติที่ดี 1. **Extend**: ใช้วิดีโอต้นทางที่สะอาดและนิ่ง เพื่อให้โมเดลดำเนินการเคลื่อนไหวต่อได้โดยไม่มี artefacts. 2. **Transition**: ใช้ `negative_prompt` คู่กับ `seed` เมื่อคุณต้องการทดสอบทรานซิชันที่ทำซ้ำได้. 3. **ความละเอียด**: จับคู่ `resolution` กับเป้าหมายการส่งมอบของคุณ; ความละเอียดสูงกว่าจะใช้เวลาประมวลผลนานขึ้น. 4. **Polling**: Poll ทุก 5–10 วินาทีจนกว่า `task_status` จะเป็น `succeed` หรือ `failed`.