# API Pixverse C1 เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Pixverse C1 ทุกตัวแปรใช้ endpoint งานวิดีโอแบบรวมเดียวกัน ## ตัวแปรของโมเดล | โมเดล | ID | คำอธิบาย | | ----- | --- | ----------- | | **Pixverse C1 Text to Video** | `pixverse-c1-text-to-video` | สร้างวิดีโอจากพรอมต์ข้อความ | | **Pixverse C1 Image to Video** | `pixverse-c1-image-to-video` | ทำแอนิเมชันจากภาพเฟรมแรกเพียงภาพเดียว | | **Pixverse C1 Transition** | `pixverse-c1-transition` | สร้างทรานซิชันระหว่างภาพเฟรมแรกและภาพเฟรมสุดท้าย | ## เปรียบเทียบอย่างรวดเร็ว | ฟีเจอร์ | Text to Video | Image to Video | Transition | | ------- | ------------- | -------------- | ---------- | | `prompt` | จำเป็น | จำเป็น | จำเป็น | | `aspect_ratio` | ไม่บังคับ (ค่าเริ่มต้น `16:9`); ดูอัตราส่วนที่รองรับด้านล่าง | ไม่ใช้ (ตามภาพอินพุต) | ไม่ใช้ (ตามภาพอินพุต) | | `image_url` | — | จำเป็น | จำเป็น (เฟรมแรก) | | `image_end_url` | — | — | จำเป็น (เฟรมสุดท้าย) | | ระยะเวลา | 1–15 วินาที | 1–15 วินาที | 1–15 วินาที | | ความละเอียด | `360p`, `540p`, `720p`, `1080p` | เหมือนกัน | เหมือนกัน | | เสียง | ไม่บังคับผ่าน `sound` | ไม่บังคับผ่าน `sound` | ไม่บังคับผ่าน `sound` | โมเดล text-to-video รองรับอัตราส่วนภาพ: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse C1 Text to Video ### Endpoint ``` POST /api/v1/video/task ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-c1-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-c1-text-to-video', prompt: 'A drone shot over coastline at golden hour', duration: 5, resolution: '720p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Image to Video ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-c1-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-c1-image-to-video', prompt: 'Slow zoom in; soft natural motion', duration: 5, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: false, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Transition สร้างการเคลื่อนไหวระหว่างภาพ keyframe **แรก** และ **สุดท้าย**. ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ประเภท | คำอธิบาย | | --------- | ---- | ----------- | | `model_name` | string | ต้องเป็น `"pixverse-c1-transition"` | | `prompt` | string | อธิบายการเคลื่อนไหวระหว่างสองเฟรม | | `duration` | integer | ความยาววิดีโอเป็นวินาที (`1`–`15`) | | `resolution` | string | หนึ่งใน `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | URL ของภาพเฟรมแรก | | `image_end_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-c1-transition', prompt: 'Smooth cinematic morph between the two scenes', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, }), }); 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. **ความละเอียด**: ใช้ `720p` หรือ `1080p` เพื่อสมดุลระหว่างคุณภาพและเวลาสร้าง; ใช้ `360p` หรือ `540p` เพื่อการทำซ้ำที่เร็วขึ้น. 2. **ทรานซิชัน**: ใช้เฟรมแรกและเฟรมสุดท้ายที่คมชัด มีแสงดี เพื่อให้โมเดลแทรกการเคลื่อนไหวได้อย่างน่าเชื่อถือ. 3. **เสียง**: ตั้งค่า `sound` เมื่อคุณต้องการเสียงบรรยากาศที่ซิงโครไนซ์; เว้นไว้หรือตั้งเป็น `false` สำหรับเอาต์พุตแบบไม่มีเสียง. 4. **Polling**: Poll ทุก 5–10 วินาทีจนกว่า `task_status` จะเป็น `succeed` หรือ `failed`.