# Seedance 2.5 Flash API เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Seedance 2.5 Flash ของ ByteDance ## รุ่นของโมเดล API นี้รองรับโมเดลสามรุ่นดังต่อไปนี้ | โมเดล | ID | คำอธิบาย | |-------|----|-------------| | **Seedance 2.5 Flash Text to Video** | `seedance-v2.5-flash-text-to-video` | สร้างวิดีโอคุณภาพสูงจากข้อความ | | **Seedance 2.5 Flash Image to Video** | `seedance-v2.5-flash-image-to-video` | สร้างวิดีโอจากเฟรมแรก หรือจากทั้งเฟรมแรกและเฟรมสุดท้าย | | **Seedance 2.5 Flash Reference to Video** | `seedance-v2.5-flash-reference-to-video` | สร้างวิดีโอโดยใช้รูปภาพ วิดีโอ และเสียงเป็นสื่ออ้างอิง | ## ตารางเปรียบเทียบ | คุณสมบัติ | ข้อความเป็นวิดีโอ | รูปภาพเป็นวิดีโอ | สื่ออ้างอิงเป็นวิดีโอ | |---------|---------------|----------------|--------------------| | ช่วงความยาว | 4–30 วินาที | 4–30 วินาที | 4–30 วินาที | | ตัวเลือกความละเอียด | 480p, 720p | 480p, 720p | 480p, 720p | | อัตราส่วนภาพ | ไม่บังคับ (ค่าเริ่มต้น 16:9) | ไม่รองรับ | ไม่บังคับ (ค่าเริ่มต้น 16:9) | | สื่อที่จำเป็น | ไม่มี | รูปภาพเฟรมแรก | ไม่มี | | สื่อที่ไม่บังคับ | ไม่มี | รูปภาพเฟรมสุดท้าย | รูปภาพ วิดีโอ และเสียง | ### อัตราส่วนภาพที่รองรับ การสร้างวิดีโอจากข้อความและจากสื่ออ้างอิงรองรับอัตราส่วนต่อไปนี้ `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` การสร้างวิดีโอจากรูปภาพไม่รองรับพารามิเตอร์ `aspect_ratio` ### ตัวเลือกความละเอียด | ความละเอียด | คำอธิบาย | |------------|-------------| | `480p` | ความคมชัดมาตรฐาน | | `720p` | ความคมชัดสูง | ## Seedance 2.5 Flash Text to Video ### เอนด์พอยต์ ``` POST /api/v1/video/task ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.5-flash-text-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ ยาวไม่เกิน 5000 อักขระ | | `resolution` | string | ความละเอียดเอาต์พุต `"480p"` หรือ `"720p"` ไม่มีค่าเริ่มต้น | | `duration` | integer | ความยาววิดีโอเป็นจำนวนเต็มตั้งแต่ 4 ถึง 30 วินาที เพิ่มทีละ 1 วินาที ไม่มีค่าเริ่มต้น | #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `aspect_ratio` | string | อัตราส่วนภาพวิดีโอเลือกได้จาก `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` หรือ `"3:4"` ค่าเริ่มต้นคือ `"16:9"` | | `sound` | boolean | กำหนดว่าจะสร้างเสียงหรือไม่ ค่าเริ่มต้นคือ `true` หากตั้งเป็น `false` จะได้วิดีโอที่ไม่มีเสียง | ### ตัวอย่างคำขอ ```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: 'seedance-v2.5-flash-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.5 Flash Image to Video ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.5-flash-image-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ ยาวไม่เกิน 5000 อักขระ | | `resolution` | string | ความละเอียดเอาต์พุต `"480p"` หรือ `"720p"` ไม่มีค่าเริ่มต้น | | `duration` | integer | ความยาววิดีโอเป็นจำนวนเต็มตั้งแต่ 4 ถึง 30 วินาที เพิ่มทีละ 1 วินาที ไม่มีค่าเริ่มต้น | | `image_url` | string | URL ของรูปภาพเฟรมแรก ดูข้อจำกัดของสื่อด้านล่าง อัตราส่วนภาพของวิดีโอที่ได้จะตรงกับรูปภาพนี้ | #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `image_end_url` | string | URL ของรูปภาพเฟรมสุดท้าย (ไม่บังคับ) ดูข้อจำกัดของสื่อด้านล่าง แนะนำให้ใช้อัตราส่วนภาพเดียวกับเฟรมแรก | | `sound` | boolean | กำหนดว่าจะสร้างเสียงหรือไม่ ค่าเริ่มต้นคือ `true` หากตั้งเป็น `false` จะได้วิดีโอที่ไม่มีเสียง | > อย่าใส่ `aspect_ratio` ในคำขอสร้างวิดีโอจากรูปภาพ เนื่องจากโมเดลนี้ไม่รองรับพารามิเตอร์ดังกล่าว ### ตัวอย่างคำขอ ```javascript { model_name: 'seedance-v2.5-flash-image-to-video', image_url: 'https://example.com/first-frame.jpg', image_end_url: 'https://example.com/last-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', resolution: '720p', duration: 8, sound: true } ``` ## Seedance 2.5 Flash Reference to Video ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.5-flash-reference-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ ยาวไม่เกิน 5000 อักขระ เขียนพรอมต์ทั่วไปโดยไม่ใส่ตัวยึดตำแหน่ง หรือใช้ฟีเจอร์อ้างอิง @ (AT) กับ `<<>>`, `<<>>` และ `<<>>` เพื่อระบุรายการในอาร์เรย์สื่อที่ตรงกันโดยตรง | | `resolution` | string | ความละเอียดเอาต์พุต `"480p"` หรือ `"720p"` ไม่มีค่าเริ่มต้น | | `duration` | integer | ความยาววิดีโอเป็นจำนวนเต็มตั้งแต่ 4 ถึง 30 วินาที เพิ่มทีละ 1 วินาที ไม่มีค่าเริ่มต้น | #### สื่ออ้างอิง สื่ออ้างอิงทุกประเภทเป็นตัวเลือก สามารถส่งเฉพาะรูปภาพ เฉพาะวิดีโอ เฉพาะเสียง หรือไม่ส่งสื่ออ้างอิงเลยก็ได้ หากไม่มีสื่ออ้างอิง แนะนำให้ใช้โมเดลสร้างวิดีโอจากข้อความ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `images` | string[] | URL รูปภาพอ้างอิง 0–10 รายการ อ้างอิงตามลำดับในอาร์เรย์ ดูข้อจำกัดของสื่อด้านล่าง | | `videos` | string[] | URL วิดีโออ้างอิงรูปแบบ MP4 หรือ MOV จำนวน 0–5 รายการ แต่ละวิดีโอต้องยาว 2–30 วินาที รวมกันไม่เกิน 30 วินาที ดูข้อจำกัดของสื่อด้านล่าง เมื่อคิดค่าบริการ ระบบจะปัดความยาวรวมของวิดีโออ้างอิงเป็นวินาทีที่ใกล้ที่สุด (ครึ่งวินาทีปัดขึ้น) แล้วบวกกับความยาวของวิดีโอที่สร้าง | | `audios` | string[] | URL เสียงอ้างอิงรูปแบบ WAV หรือ MP3 จำนวน 0–5 รายการ แต่ละไฟล์ต้องยาว 2–30 วินาทีและมีขนาดไม่เกิน 15 MB โดยมีความยาวรวมไม่เกิน 30 วินาที | #### ตัวยึดตำแหน่งสำหรับอ้างอิงด้วย @ (AT) ฟีเจอร์อ้างอิง @ (AT) เชื่อมสื่ออ้างอิงกับพรอมต์ผ่านตัวยึดตำแหน่ง `<<<...>>>` ที่มีหมายเลข แต่ละประเภทสื่อเริ่มนับจาก `1` แยกกันตามลำดับในอาร์เรย์ของประเภทนั้น | ตัวยึดตำแหน่ง | ค่าที่อ้างถึง | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | ตัวอย่างเช่น หากรูปแรกใช้อ้างอิงตัวละครและรูปที่สองใช้อ้างอิงฉาก ให้ใช้ `<<>>` สำหรับตัวละครและ `<<>>` สำหรับฉากใน `prompt` ตัวยึดตำแหน่งแต่ละตัวต้องชี้ไปยังรายการที่มีอยู่ในอาร์เรย์ที่ตรงกัน #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `aspect_ratio` | string | อัตราส่วนภาพวิดีโอเลือกได้จาก `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` หรือ `"3:4"` ค่าเริ่มต้นคือ `"16:9"` | | `sound` | boolean | กำหนดว่าจะสร้างเสียงหรือไม่ ค่าเริ่มต้นคือ `true` หากตั้งเป็น `false` จะได้วิดีโอที่ไม่มีเสียง | ### ตัวอย่างคำขอ ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', resolution: '720p', duration: 8, aspect_ratio: '16:9', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### ตัวอย่างคำขอสร้างวิดีโอจากสื่ออ้างอิงด้วย @ (AT) ```javascript { model_name: 'seedance-v2.5-flash-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', resolution: '720p', duration: 10, aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.png' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## ข้อจำกัดของสื่อ ข้อจำกัดเหล่านี้ใช้กับรูปภาพเฟรมแรก รูปภาพเฟรมสุดท้าย และสื่ออ้างอิงของโมเดลในหน้านี้ | สื่อ | รูปแบบ | ข้อจำกัด | |-------|---------|--------| | รูปภาพ | JPEG, PNG, WEBP, BMP, TIFF, GIF, HEIC, HEIF | แต่ละรูปต้องเล็กกว่า 30 MB ความกว้างและความสูงด้านละ 300–6000 px อัตราส่วนความกว้างต่อความสูง 0.4–2.5 | | วิดีโอ | MP4, MOV | แต่ละไฟล์ไม่เกิน 200 MB ความกว้างและความสูงด้านละ 300–6000 px อัตราส่วนความกว้างต่อความสูง 0.4–2.5 อัตราเฟรม 24–60 FPS และจำนวนพิกเซลรวม 407696–8295044 | | เสียง | WAV, MP3 | แต่ละไฟล์ไม่เกิน 15 MB | เสียงอ้างอิงและวิดีโออ้างอิงมีความยาวรวมได้ประเภทละไม่เกิน 30 วินาที จำนวนรายการนับแยกกัน โดยใช้รูปภาพได้ไม่เกิน 10 รูป วิดีโอไม่เกิน 5 รายการ และคลิปเสียงไม่เกิน 5 คลิป ทุกโมเดลต้องระบุ `resolution` และ `duration` ซึ่งไม่มีค่าเริ่มต้น หากไม่ระบุ `aspect_ratio` โมเดลสร้างวิดีโอจากข้อความและจากสื่ออ้างอิงจะใช้ `16:9` ตัวเลือกเสียงมีค่าเริ่มต้นเป็น `true` หากต้องการวิดีโอที่ไม่มีเสียง ให้ตั้งเป็น `false` ## รูปแบบการตอบกลับ ### การตอบกลับครั้งแรก ทุกโมเดลส่งคืน `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" } } ``` ### การตอบกลับเมื่อสอบถามสถานะ เรียก `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`: การสร้างวิดีโอล้มเหลว ## ระยะเวลาประมวลผล ระยะเวลาประมวลผลขึ้นอยู่กับความยาววิดีโอ ความละเอียด และสถานะคิวในขณะนั้น สอบถามสถานะทุก 5–10 วินาที ## แนวทางปฏิบัติที่แนะนำ 1. **พารามิเตอร์ที่จำเป็น**: ระบุ `prompt`, `resolution` และ `duration` เสมอ ส่วน `aspect_ratio` เป็นตัวเลือกสำหรับการสร้างวิดีโอจากข้อความและจากสื่ออ้างอิง โดยมีค่าเริ่มต้นเป็น `16:9` 2. **อัตราส่วนภาพเมื่อสร้างวิดีโอจากรูปภาพ**: อย่าส่ง `aspect_ratio` ในคำขอสร้างวิดีโอจากรูปภาพ 3. **วิดีโออ้างอิง**: ไม่จำเป็นต้องส่งวิดีโอ หากส่ง ความยาวของแต่ละวิดีโอและความยาวรวมต้องอยู่ในขีดจำกัดที่ระบุไว้ 4. **รูปภาพอ้างอิง**: จะส่งรูปภาพหรือไม่ก็ได้ ไม่ว่าจะมีวิดีโอหรือเสียงหรือไม่ โดยส่ง URL รูปภาพที่รองรับได้สูงสุด 10 รายการ 5. **เสียงอ้างอิง**: คลิปเสียงแต่ละคลิปต้องยาว 2–30 วินาทีและไม่เกิน 15 MB โดยมีความยาวรวมไม่เกิน 30 วินาที 6. **ลำดับการอ้างอิง**: เรียงรายการใน `images`, `videos` และ `audios` ตามลำดับที่ต้องการ และอ้างถึงในพรอมต์ให้ตรงกับลำดับนั้น 7. **เสียง**: ไม่ต้องระบุ `sound` หากต้องการใช้ค่าเริ่มต้น `true` หรือตั้งเป็น `false` เพื่อปิดการสร้างเสียง