# Seedance 2.0 API เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Seedance 2.0 ของ ByteDance ## รุ่นของโมเดล API นี้รองรับโมเดลหกรุ่น: | โมเดล | ID | คำอธิบาย | |-------|-----|-------------| | **Seedance 2.0 Text to Video** | `seedance-v2.0-text-to-video` | สร้างวิดีโอคุณภาพสูงจากข้อความ | | **Seedance 2.0 Image to Video** | `seedance-v2.0-image-to-video` | สร้างภาพเคลื่อนไหวจากภาพพร้อมควบคุมการเคลื่อนไหว | | **Seedance 2.0 Reference to Video** | `seedance-v2.0-reference-to-video` | สร้างวิดีโอโดยใช้วิดีโออ้างอิงเป็นแนวทาง | | **Seedance 2.0 Fast Text to Video** | `seedance-v2.0-fast-text-to-video` | สร้างวิดีโอจากข้อความได้เร็วขึ้น | | **Seedance 2.0 Fast Image to Video** | `seedance-v2.0-fast-image-to-video` | สร้างวิดีโอจากภาพได้เร็วขึ้น | | **Seedance 2.0 Fast Reference to Video** | `seedance-v2.0-fast-reference-to-video` | สร้างวิดีโอจากสื่ออ้างอิงได้เร็วขึ้น | ## เปรียบเทียบโดยย่อ | คุณสมบัติ | โมเดลมาตรฐาน | โมเดล Fast | |---------|-----------------|-------------| | คุณภาพ | คุณภาพสูงกว่า | ปรับให้เหมาะกับความเร็ว | | เวลาประมวลผล | 3-8 นาที | 1-4 นาที | | ช่วงความยาว | 4-15 วินาที | 4-15 วินาที | | ตัวเลือกความละเอียด | 480p, 720p, 1080p, 4k | 480p, 720p | | สื่ออ้างอิง | ภาพ วิดีโอ และเสียงสำหรับ Reference-to-Video | ภาพ วิดีโอ และเสียงสำหรับ Fast Reference-to-Video | ### อัตราส่วนภาพที่รองรับ `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ### ตัวเลือกความละเอียด | ความละเอียด | คำอธิบาย | |------------|-------------| | `480p` | ความคมชัดมาตรฐาน ประมวลผลเร็วขึ้น | | `720p` | ความคมชัดสูง สมดุลระหว่างคุณภาพและความเร็ว | | `1080p` | Full HD ใช้ได้กับโมเดล Seedance 2.0 มาตรฐานทุกรุ่น | | `4k` | Ultra HD ใช้ได้กับโมเดล Seedance 2.0 มาตรฐานทุกรุ่น | ## Seedance 2.0 ข้อความเป็นวิดีโอ ### จุดเชื่อมต่อ ``` POST /api/v1/video/task ``` ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.0-text-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ | | `duration` | integer | ความยาววิดีโอเป็นวินาทีจำนวนเต็ม (4-15) เพิ่มทีละ 1 | | `resolution` | string | ความละเอียดเอาต์พุต: `"480p"`, `"720p"`, `"1080p"` หรือ `"4k"` | | `aspect_ratio` | string | อัตราส่วนภาพวิดีโอ: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` หรือ `"3:4"` | #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `sound` | boolean | กำหนดว่าจะสร้างเสียงหรือไม่ ค่าเริ่มต้นคือ `true` และไม่ส่งผลต่อราคา | ### ตัวอย่างคำขอ ```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.0-text-to-video', prompt: 'A golden retriever running through a sunlit meadow', duration: 6, resolution: '720p', aspect_ratio: '16:9' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Seedance 2.0 ภาพเป็นวิดีโอ ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.0-image-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ | | `duration` | integer | ความยาววิดีโอเป็นวินาทีจำนวนเต็ม (4-15) เพิ่มทีละ 1 | | `resolution` | string | ความละเอียดเอาต์พุต: `"480p"`, `"720p"`, `"1080p"` หรือ `"4k"` | | `aspect_ratio` | string | อัตราส่วนภาพวิดีโอ: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` หรือ `"3:4"` | | `image_url` | string | เฟรมแรกของวิดีโอ | #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `image_end_url` | string | URL ภาพเฟรมสุดท้าย ซึ่งไม่บังคับ | | `sound` | boolean | กำหนดว่าจะสร้างเสียงหรือไม่ ค่าเริ่มต้นคือ `true` และไม่ส่งผลต่อราคา | ### ตัวอย่างคำขอ ```javascript { model_name: 'seedance-v2.0-image-to-video', image_url: 'https://example.com/image.jpg', image_end_url: 'https://example.com/end-frame.jpg', prompt: 'Camera slowly pulls back to reveal the full landscape', duration: 6, resolution: '720p', aspect_ratio: '16:9' } ``` ## Seedance 2.0 สื่ออ้างอิงเป็นวิดีโอ ### พารามิเตอร์คำขอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.0-reference-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ เขียนพรอมต์ทั่วไปโดยไม่ใช้ตัวแทนค่า หรือเลือกใช้ฟีเจอร์อ้างอิง @ (AT) กับ `<<>>`, `<<>>` และ `<<>>` เพื่ออ้างถึงรายการในอาร์เรย์สื่อที่ตรงกันอย่างชัดเจน | | `duration` | integer | ความยาววิดีโอเป็นวินาทีจำนวนเต็ม (4-15) เพิ่มทีละ 1 | | `resolution` | string | ความละเอียดเอาต์พุต: `"480p"`, `"720p"`, `"1080p"` หรือ `"4k"` | | `aspect_ratio` | string | อัตราส่วนภาพวิดีโอ: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` หรือ `"3:4"` | #### สื่ออ้างอิง ส่งภาพ 1-9 ภาพ สามารถละเว้นภาพได้เฉพาะเมื่อมีวิดีโออ้างอิงอย่างน้อยหนึ่งรายการเท่านั้น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `images` | string[] | URL ภาพอ้างอิง 1-9 รายการ หรืออาร์เรย์ว่างเมื่อ `videos` ไม่ว่าง | | `videos` | string[] | URL วิดีโออ้างอิงสูงสุด 3 รายการ แต่ละวิดีโอต้องยาว 2-15 วินาที และมีความยาวรวมไม่เกิน 15 วินาที | | `audios` | string[] | URL เสียงอ้างอิงสูงสุด 3 รายการ แต่ละคลิปต้องยาว 2-15 วินาที และมีความยาวรวมไม่เกิน 15 วินาที; WAV หรือ MP3 ไม่เกิน 15 MB ต่อคลิป; ต้องมีภาพหรือวิดีโออย่างน้อยหนึ่งรายการ | #### ตัวแทนค่าอ้างอิง @ (AT) ฟีเจอร์อ้างอิง @ (AT) เชื่อมสื่ออ้างอิงกับพรอมต์ผ่านตัวแทนค่า `<<<...>>>` ที่มีหมายเลข การนับเริ่มจาก `1` แยกตามประเภทสื่อ และเรียงตามอาร์เรย์ที่เกี่ยวข้อง: | ตัวแทนค่า | ค่าที่อ้างอิง | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `videos[0]` | | `<<>>` | `audios[0]` | ตัวอย่างเช่น หากภาพแรกเป็นตัวละครอ้างอิงและภาพที่สองเป็นฉากอ้างอิง ให้ใช้ `<<>>` สำหรับตัวละครและ `<<>>` สำหรับฉากใน `prompt` ตัวแทนค่าแต่ละตัวต้องชี้ไปยังรายการที่มีอยู่จริงในอาร์เรย์ที่เกี่ยวข้อง #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `sound` | boolean | กำหนดว่าจะสร้างเสียงที่ซิงก์กันหรือไม่ ค่าเริ่มต้นคือ `true` | ### ตัวอย่างคำขอ ```javascript { model_name: 'seedance-v2.0-reference-to-video', prompt: 'Use image one for the subject, video one for the movement, and audio one for the atmosphere', duration: 8, resolution: '1080p', 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.0-reference-to-video', prompt: 'Place the explorer from <<>> in the environment from <<>>, following the camera movement in <<>> and speaking with the reference voice from <<>>', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, images: [ 'https://example.com/explorer-reference.jpg', 'https://example.com/environment-reference.jpg' ], videos: ['https://example.com/camera-movement-reference.mp4'], audios: ['https://example.com/voice-reference.mp3'] } ``` ## รุ่น Fast รุ่น Fast ให้ความสำคัญกับความเร็วในการประมวลผล โมเดล Fast ทุกรุ่นรองรับเอาต์พุตเฉพาะ `"480p"` และ `"720p"` โครงสร้างคำขอส่วนอื่นของ Fast ข้อความเป็นวิดีโอและ Fast ภาพเป็นวิดีโอเหมือนกับโมเดลมาตรฐานที่ตรงกัน ส่วน Fast สื่ออ้างอิงเป็นวิดีโอใช้ข้อจำกัดสื่ออ้างอิงเดียวกับโมเดลอ้างอิงมาตรฐาน ### ตัวอย่างคำขอ Fast ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Use image one for the subject, follow the movement from video one, and use audio one for the atmosphere', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: ['https://example.com/subject-reference.jpg'], videos: ['https://example.com/motion-reference.mp4'], audios: ['https://example.com/atmosphere-reference.mp3'] } ``` ### ตัวอย่างคำขอ Fast สื่ออ้างอิงเป็นวิดีโอด้วย @ (AT) ```javascript { model_name: 'seedance-v2.0-fast-reference-to-video', prompt: 'Have the dancer from <<>> perform the movement from <<>> on the stage in <<>>, using the rhythm from <<>>', duration: 8, resolution: '720p', aspect_ratio: '9:16', sound: true, images: [ 'https://example.com/dancer-reference.jpg', 'https://example.com/stage-reference.jpg' ], videos: ['https://example.com/dance-movement-reference.mp4'], audios: ['https://example.com/rhythm-reference.mp3'] } ``` ### พารามิเตอร์ Seedance 2.0 Fast สื่ออ้างอิงเป็นวิดีโอ #### จำเป็น | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `model_name` | string | ต้องเป็น `"seedance-v2.0-fast-reference-to-video"` | | `prompt` | string | พรอมต์สำหรับสร้างวิดีโอ เขียนพรอมต์ทั่วไปโดยไม่ใช้ตัวแทนค่า หรือเลือกใช้ฟีเจอร์อ้างอิง @ (AT) กับ `<<>>`, `<<>>` และ `<<>>` เพื่ออ้างถึงรายการในอาร์เรย์สื่อที่ตรงกันอย่างชัดเจน | | `duration` | integer | ความยาววิดีโอเป็นวินาทีจำนวนเต็ม (4-15) เพิ่มทีละ 1 | | `resolution` | string | ความละเอียดเอาต์พุต: `"480p"` หรือ `"720p"` | | `aspect_ratio` | string | อัตราส่วนภาพวิดีโอ: `"21:9"`, `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"` หรือ `"3:4"` | #### สื่ออ้างอิง | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `images` | string[] | URL ภาพอ้างอิง 1-9 รายการ หรืออาร์เรย์ว่างเมื่อ `videos` ไม่ว่าง | | `videos` | string[] | URL วิดีโออ้างอิงสูงสุด 3 รายการ แต่ละวิดีโอต้องยาว 2-15 วินาที และมีความยาวรวมไม่เกิน 15 วินาที | | `audios` | string[] | URL เสียงอ้างอิงสูงสุด 3 รายการ แต่ละคลิปต้องยาว 2-15 วินาที และมีความยาวรวมไม่เกิน 15 วินาที; WAV หรือ MP3 ไม่เกิน 15 MB ต่อคลิป; ต้องมีภาพหรือวิดีโออย่างน้อยหนึ่งรายการ | กฎตัวแทนค่าที่เริ่มนับจาก 1 ข้างต้นใช้กับโมเดล Fast สื่ออ้างอิงเป็นวิดีโอด้วย #### ไม่บังคับ | พารามิเตอร์ | ชนิด | คำอธิบาย | |-----------|------|-------------| | `sound` | boolean | กำหนดว่าจะสร้างเสียงที่ซิงก์กันหรือไม่ ค่าเริ่มต้นคือ `true` | ## ข้อจำกัดสื่อ ข้อจำกัดเหล่านี้ใช้กับภาพเฟรมแรก ภาพเฟรมสุดท้าย และสื่ออ้างอิงของโมเดลในหน้านี้ | สื่อ | รูปแบบ | ข้อจำกัด | |-------|---------|--------| | ภาพ | 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 | | เสียง | WAV, MP3 | ไม่เกิน 15 MB ต่อไฟล์ | | เนื้อหาคำขอ | — | ไม่เกิน 64 MB | เสียงอ้างอิงและวิดีโออ้างอิงมีขีดจำกัดความยาวรวมแยกกันประเภทละ 15 วินาที จำนวนแต่ละประเภทเป็นอิสระ: ภาพสูงสุด 9 ภาพ วิดีโอ 3 รายการ และเสียง 3 คลิป การเพิ่มวิดีโอไม่ลดจำนวนภาพที่อนุญาต โมเดลทุกรุ่นมีค่าเริ่มต้นเป็น `720p` แต่ยังต้องระบุ `resolution` สวิตช์เสียงมีค่าเริ่มต้นเป็น `true` โดยทั้งสวิตช์นี้และเสียงอ้างอิงไม่ทำให้ราคาเปลี่ยน สื่ออ้างอิงเป็นวิดีโอต้องมีภาพหรือวิดีโออย่างน้อยหนึ่งรายการ และไม่รองรับคำขอที่มีเฉพาะเสียง การอัปโหลดวิดีโออ้างอิงจะเพิ่มค่าบริการสร้างเป็นสองเท่า ไม่ว่าจำนวนหรือความยาวจะเท่าใด ## รูปแบบการตอบกลับ ### การตอบกลับเริ่มต้น โมเดลทุกรุ่นส่งคืน `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`: สร้างวิดีโอไม่สำเร็จ ## เวลาประมวลผล **โมเดลมาตรฐาน**: 3-8 นาที ขึ้นอยู่กับความยาวและความละเอียด **โมเดล Fast**: 1-4 นาที สำหรับการตั้งค่าส่วนใหญ่ ตรวจสอบสถานะทุก 5-10 วินาที ## แนวทางปฏิบัติที่แนะนำ 1. **เลือกรุ่นที่เหมาะสม**: ใช้โมเดล Fast สำหรับทดลองปรับ และโมเดลมาตรฐานสำหรับผลลัพธ์สุดท้าย 2. **อธิบายการเคลื่อนไหวให้ชัดเจน**: ระบุรายละเอียดการเคลื่อนไหวที่เฉพาะเจาะจงในพรอมต์ 3. **เลือกความละเอียด**: โมเดล Seedance 2.0 มาตรฐานทุกรุ่นรองรับ `480p`, `720p`, `1080p` และ `4k`; โมเดล Fast ทุกรุ่นรองรับเฉพาะ `480p` และ `720p` 4. **ลำดับสื่ออ้างอิง**: จัด `images`, `videos` และ `audios` ตามลำดับที่ตั้งใจ และอ้างอิงให้สอดคล้องกันในพรอมต์ 5. **คำขอที่มีเฉพาะวิดีโอ**: ใช้อาร์เรย์ `images` ว่างเฉพาะเมื่อมีวิดีโออ้างอิงอย่างน้อยหนึ่งรายการ 6. **ความยาวสื่อ**: ให้เสียงและวิดีโออ้างอิงแต่ละรายการมีความยาว 2 ถึง 15 วินาที 7. **การใช้เสียง**: ละเว้น `sound` เพื่อใช้ค่าเริ่มต้น `true` หรือตั้งเป็น `false` เพื่อปิดการสร้างเสียง