ข้ามไปที่เอกสารประกอบ
ในหน้านี้

Seedance 2.5 Flash

สร้างวิดีโอด้วย Seedance 2.5 Flash โดยใช้ข้อความ เฟรมแรกและเฟรมสุดท้าย หรืออินพุตอ้างอิงแบบมัลติโมดอล หน้านี้จะครอบคลุมขั้นตอนการทำงานตั้งแต่การส่งรีเควสไปจนถึงการรับผลลัพธ์ของโมเดลนี้ทั้งหมด

ID โมเดลของ API: seedance-2-5-flash

การสร้างวิดีโอจะทำงานแบบอะซิงโครนัส (Asynchronous) โปรดบันทึก taskId ที่ได้รับจากการสร้างงาน จากนั้นสืบค้นสถานะงานหรือรอรับข้อมูลผ่านเว็บฮุก

ความสามารถ

Seedance 2.5 Flash รองรับ 480p และ 720p โดยมี 720p เป็นค่าเริ่มต้น ไม่รองรับ 1080p, 4k, ดราฟต์ตัวอย่าง หรือการแปลงดราฟต์เป็นวิดีโอสุดท้าย
ฟีเจอร์ค่าที่รองรับ
ความละเอียดวิดีโอผลลัพธ์480p · 720p
ความยาววิดีโอผลลัพธ์4–30 วินาที
อัตราส่วนภาพ16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
รูปภาพอ้างอิงรูปภาพสูงสุด 30 รูป
วิดีโออ้างอิงวิดีโอสูงสุด 10 ไฟล์
ไฟล์เสียงอ้างอิงไฟล์เสียงสูงสุด 10 ไฟล์
สื่ออ้างอิงทั้งหมดรวมกันไฟล์อ้างอิงรวมสูงสุด 50 ไฟล์
ความยาวรวมต่อกลุ่มวิดีโอ/เสียง30 วินาที
seed-1 ถึง 2147483647
สามารถใช้ duration=-1 ในโหมด reference-to-video ได้เช่นกัน ดูรายละเอียดการตัดต่อวิดีโอและราคาด้านล่าง โหมด image-to-video รองรับเฉพาะค่า adaptive เท่านั้น โปรดละเว้นฟิลด์นี้หรือตั้งค่าเป็น adaptive

ราคาและเครดิต

ระบบจะคิดค่าบริการสร้างวิดีโอเป็นเครดิตตามความยาวที่นำมาคำนวณเงินเป็นวินาที หากไม่มีการใส่คลิปวิดีโอต้นแบบ ความยาวที่นำมาคำนวณเงินจะเป็นความยาวของวิดีโอผลลัพธ์ แต่หากมีการใส่คลิปวิดีโอต้นแบบเข้ามาด้วย ก็จะนับรวมความยาวของวิดีโออ้างอิงนั้นเข้าไปด้วย

ตารางด้านล่างแสดงอัตราเครดิตที่หักต่อวินาที ไม่ใช่ค่าใช้จ่ายทั้งหมดของงาน โดยอัตราจะขึ้นอยู่กับโมเดล ความละเอียดของวิดีโอผลลัพธ์ และการใส่วิดีโออ้างอิงในโหมด Reference-to-Video คุณสามารถดูสูตรและตัวอย่างการคำนวณค่าใช้จ่ายทั้งหมดได้ที่ด้านล่างตารางนี้

ความละเอียดวิดีโอผลลัพธ์ไม่มีวิดีโออินพุตมีวิดีโออินพุต
480p7 เครดิต/วินาที5 เครดิต/วินาที
720p10 เครดิต/วินาที7 เครดิต/วินาที
  • ไม่มีวิดีโออินพุต: ความยาววิดีโอผลลัพธ์ (วินาที) × อัตราค่าบริการแบบไม่มีวิดีโอ
  • มีวิดีโออินพุต: (ความยาววิดีโอผลลัพธ์ (วินาที) + ความยาวจริงของวิดีโออ้างอิง (วินาที)) × อัตราค่าบริการแบบมีวิดีโอ เซิร์ฟเวอร์จะวัดความยาวรวมของวิดีโออ้างอิงและปัดเศษขึ้นเป็นจำนวนเต็มวินาทีก่อนคิดค่าบริการ
  • การใช้อินพุตอ้างอิงเฉพาะรูปภาพหรือเสียงอย่างเดียวจะคิดในอัตราค่าบริการแบบไม่มีวิดีโอ ส่วนอัตราค่าบริการแบบมีวิดีโออ้างอิงจะใช้ในโหมด reference-to-video เมื่อมีการส่งวิดีโออ้างอิงเท่านั้น

ตัวอย่างการคำนวณค่าใช้จ่าย

วิดีโอแบบข้อความเป็นวิดีโอ 720p ความยาว 5 วินาที: 5 × 10 = 50 เครดิต

วิดีโอผลลัพธ์ 720p ความยาว 5 วินาที พร้อมวิดีโออ้างอิงความยาว 5 วินาที: (5 + 5) × 7 = 70 เครดิต

ระบบจะหักเครดิตล่วงหน้าเมื่อสร้างงานสำเร็จ หากงานเสร็จสมบูรณ์ จะคิดค่าบริการตามยอดนี้โดยไม่มีการเรียกเก็บเพิ่มหรือคืนเงินบางส่วนตามความยาวจริงของผลลัพธ์ แต่หากงานล้มเหลวหรือหมดเวลา ระบบจะดำเนินการคืนเงินให้ตามขั้นตอน

ระบบจะสำรองเครดิตเมื่อส่งงานและจะหักเครดิตจริงเมื่อทำรายการสำเร็จ หากงานล้มเหลวหรือหมดเวลาจะเข้าสู่ขั้นตอนการคืนเครดิต หากสถานะการเรียกเก็บเงินแสดงเป็น refund_failed หมายความว่าการคืนเครดิตไม่เสร็จสมบูรณ์ โปรดตรวจสอบบันทึกการใช้งาน API หรือติดต่อฝ่ายสนับสนุน

การคิดเครดิตเมื่อ duration=-1

เมื่อตั้งค่าความยาวเป็น -1 ความยาวของผลลัพธ์สุดท้ายจะไม่คงที่ โดยระบบจะปล่อยให้โมเดลเป็นผู้กำหนดเอง

ในกรณีส่วนใหญ่ แนะนำให้กำหนดความยาวตามความยาววิดีโอที่คุณต้องการใช้งานจริงแทนการตั้งค่าเป็น -1 ทั้งนี้ เราขอแนะนำให้ใช้ค่า -1 สำหรับการตัดต่อวิดีโอเท่านั้น ไม่แนะนำสำหรับการสร้างวิดีโอในรูปแบบอื่นๆ

อินพุตอ้างอิงวิธีการคำนวณค่าบริการตัวอย่าง
กรณีมีวิดีโออ้างอิงรวมความยาวของวิดีโออ้างอิงทั้งหมดแล้วปัดเศษขึ้นเป็นวินาทีเต็มถัดไป แทนค่าด้วย T ค่าบริการจะเท่ากับ (T + T) × อัตราแบบมีวิดีโอ โดย T ตัวแรกคือระยะเวลาผลลัพธ์โดยประมาณ และ T ตัวที่สองคือระยะเวลาของวิดีโออินพุตความละเอียด 720p พร้อมวิดีโออ้างอิงความยาว 5 วินาที: (5 + 5) × 7 = 70 เครดิต
กรณีไม่มีวิดีโออ้างอิง (มีเฉพาะรูปภาพหรือเสียง)ใช้ระยะเวลาผลลัพธ์โดยประมาณที่ 30 วินาที ค่าบริการจะเท่ากับ 30 × อัตราแบบไม่มีวิดีโอความละเอียด 720p แบบไม่มีวิดีโออ้างอิง: 30 × 10 = 300 เครดิต

การยืนยันตัวตน

สร้างคีย์ API ได้ในแดชบอร์ด โดยระบบจะแสดงคีย์ตัวเต็มเพียงครั้งเดียวเท่านั้น โปรดเก็บรักษาไว้บนเซิร์ฟเวอร์ของคุณและส่งมาในรูปแบบ Bearer token ในทุกรีเควส

Base URL

https://api.seevio.ai
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

ตั้งค่าตัวแปรสภาพแวดล้อม SEEVIO_API_KEY ก่อนรันตัวอย่างเหล่านี้ ตัวอย่าง JavaScript จะทำงานบนเซิร์ฟเวอร์ด้วย Node.js ส่วนตัวอย่าง Python จะใช้แพ็กเกจ requests

เริ่มต้นด่วน

ส่งรีเควสแบบย่อนี้ บันทึก taskId ที่ได้รับ จากนั้นใช้ตัวอย่างการสืบค้นสถานะงานด้านล่าง โดยค่าเครดิตที่แสดงในการตอบกลับเมื่อสร้างงานจะเป็นจำนวนเครดิตที่ถูกสำรองไว้

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

ตัวอย่างการตอบกลับเมื่อสร้างงาน

หลังจากยอมรับคำขอข้างต้นแล้ว API จะส่งคืนการตอบกลับแบบ JSON นี้ โดย taskId คือรหัสประจำตัวงานที่ใช้สำหรับการสอบถามสถานะในภายหลัง และ credits คือจำนวนเครดิตที่สำรองไว้สำหรับงานนี้ การตอบกลับนี้เป็นการยืนยันการสร้างงานเท่านั้น ไม่ได้หมายความว่าวิดีโอพร้อมใช้งานแล้ว คุณต้องทำการดึงข้อมูลสถานะงาน (poll) หรือใช้ Webhook เพื่อรับผลลัพธ์วิดีโอ

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

สร้างงาน

POST https://api.seevio.ai/v1/videos/generations

ส่งออบเจกต์ JSON ที่ระบุ model และ input พร้อมระบุ callback_url (ไม่บังคับ) ทั้งนี้ โปรดระบุ ID ของโมเดลที่แสดงบนหน้านี้เสมอ หากละเว้นระบบจะเลือกเป็น seedance-2-0 โดยอัตโนมัติ

Request body

ฟิลด์ประเภทจำเป็นคำอธิบายและข้อจำกัด
model
stringใช่

รหัสโมเดล หากต้องการใช้ Seedance 2.5 Flash ให้ตั้งค่าฟิลด์นี้เป็น seedance-2-5-flash

callback_url
stringไม่ใช่

URL ปลายทาง HTTPS สาธารณะสำหรับการส่งคอลแบ็กแบบ POST เมื่อทำรายการสำเร็จหรือล้มเหลว ไม่อนุญาตให้ใช้เครือข่ายส่วนตัวและ localhost

ตัวอย่าง: https://example.com/webhooks/seevio
input
objectใช่

การตั้งค่าการสร้างวิดีโอ ต้องมี prompt ที่ไม่ว่างเปล่า

พารามิเตอร์อินพุต

จำเป็นต้องระบุ image_urls ในโหมด image-to-video สำหรับโหมด reference-to-video จำเป็นต้องระบุอินพุตอ้างอิงอย่างน้อยหนึ่งรายการจาก image_urls, video_urls หรือ audio_urls

โปรดระบุ image_urls, video_urls และ audio_urls ในรูปแบบอาร์เรย์ของสตริง URL (string[]) โดยทุก URL ที่ระบุจะต้องสามารถเข้าถึงได้แบบสาธารณะผ่านโปรโตคอล HTTPS ซึ่งรวมถึงไฟล์สื่อที่โหมดการทำงานปัจจุบันไม่ได้เลือกใช้งานด้วย

ฟิลด์ประเภทจำเป็นค่าเริ่มต้นคำอธิบายและข้อจำกัด
input.prompt
stringใช่—

จำเป็นต้องระบุพรอมต์ในทุกโหมด โดยสามารถใส่ได้สูงสุด 10,000 ตัวอักษร (ก่อนตัดช่องว่างส่วนเกิน) และต้องไม่เป็นเพียงช่องว่างเปล่าเท่านั้น

ตัวอย่าง: A cat surfing at sunset
input.generation_type
stringไม่ใช่text-to-video
ค่าที่รองรับ
text-to-video | image-to-video | reference-to-video

text-to-video, image-to-video หรือ reference-to-video หากละเว้น จะมีค่าเริ่มต้นเป็น text-to-video และใช้เฉพาะพรอมต์ โหมด image-to-video ใช้รูปภาพเฟรมที่จัดลำดับ 1–2 รูป โหมด reference-to-video ใช้รูปภาพ วิดีโอ และ/หรือเสียงอ้างอิง รองรับการอ้างอิงเฉพาะเสียงโดยต้องระบุพรอมต์ด้วย

input.image_urls
string[]ตามเงื่อนไข[]

ระบุ URL รูปภาพเพื่อกำหนดลักษณะภายนอก ในโหมด image-to-video ให้ระบุ 1 รูปสำหรับเฟรมแรก หรือ 2 รูปในลำดับเฟรมแรกและเฟรมสุดท้าย ในโหมด reference-to-video ให้ระบุรูปภาพได้สูงสุด 30 รูป รูปภาพแต่ละรูปต้องมีขนาดเล็กกว่า 30 MB ดูรูปแบบและขนาดภาพที่กำหนดได้ในข้อกำหนดสื่อด้านล่าง ประเภทการอ้างอิงทั้งหมดรวมกันสามารถส่งไฟล์ได้สูงสุด 50 ไฟล์ หากเว้นไว้จะมีค่าเริ่มต้นเป็น [] และจะถูกละเลยในโหมด text-to-video

ตัวอย่าง: ["https://example.com/first-frame.jpg"]
input.video_urls
string[]ตามเงื่อนไข[]

ระบุ URL วิดีโออ้างอิงเพื่อกำหนดการเคลื่อนไหว หรือแก้ไข/ต่อความยาววิดีโอ ใช้ได้เฉพาะในโหมด reference-to-video สูงสุด 10 ไฟล์ แต่ละไฟล์ขนาดไม่เกิน 100 MB และยาว 2–30 วินาที โดยความยาวรวมกันต้องไม่เกิน 30 วินาที ประเภทการอ้างอิงทั้งหมดรวมกันสามารถส่งไฟล์ได้สูงสุด 50 ไฟล์ เซิร์ฟเวอร์จะวัดระยะเวลาวิดีโอเพื่อคิดเงิน หากเว้นไว้จะมีค่าเริ่มต้นเป็น [] และจะถูกละเลยในโหมดอื่นๆ

ตัวอย่าง: ["https://example.com/source.mp4"]
input.audio_urls
string[]ตามเงื่อนไข[]

ระบุ URL เสียงอ้างอิงเพื่อกำหนดเสียงประกอบ ใช้ได้เฉพาะในโหมด reference-to-video สูงสุด 10 ไฟล์ รูปแบบ MP3/WAV แต่ละไฟล์ขนาดไม่เกิน 15 MB และยาว 2–30 วินาที โดยความยาวรวมกันต้องไม่เกิน 30 วินาที ประเภทการอ้างอิงทั้งหมดรวมกันสามารถส่งไฟล์ได้สูงสุด 50 ไฟล์ สามารถใช้เสียงเป็นประเภทการอ้างอิงเพียงอย่างเดียวได้โดยยังคงจำเป็นต้องระบุพรอมต์ หากเว้นไว้จะมีค่าเริ่มต้นเป็น [] และจะถูกละเลยในโหมดอื่นๆ

ตัวอย่าง: ["https://example.com/music.mp3"]
input.duration
integerไม่ใช่5
ค่าที่รองรับ
-1 | 4–30

ความยาววิดีโอผลลัพธ์เป็นจำนวนเต็มตั้งแต่ 4 ถึง 30 วินาที รองรับค่า -1 เฉพาะในโหมด reference-to-video เท่านั้น ใช้ร่วมกับวิดีโอต้นฉบับสำหรับการตัดต่อ โดยการคิดราคาจะเป็นไปตามกฎพิเศษข้างต้น

ตัวอย่าง: 5
input.aspect_ratio
stringไม่ใช่adaptive
ค่าที่รองรับ
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

16:9, 4:3, 1:1, 3:4, 9:16, 21:9 หรือ adaptive หากละเว้น จะมีค่าเริ่มต้นเป็น adaptive ซึ่งอนุญาตให้โมเดล AI กำหนดอัตราส่วนเอาต์พุตเอง สำหรับการแก้ไขหรือต่อความยาววิดีโอ ให้ใช้ adaptive โหมด image-to-video รองรับเฉพาะค่า adaptive เท่านั้น โปรดละเว้นฟิลด์นี้หรือตั้งค่าเป็น adaptive

ตัวอย่าง: adaptive
input.resolution
stringไม่ใช่720p
ค่าที่รองรับ
480p | 720p

480p หรือ 720p หากละเว้น จะมีค่าเริ่มต้นเป็น 720p ในทุกโหมดการสร้างที่รองรับ ความละเอียดที่สูงกว่านี้จะถูกปฏิเสธ

ตัวอย่าง: 720p
input.generate_audio
booleanไม่ใช่true
ค่าที่รองรับ
true | false

หากเป็น true จะร้องขอการสร้างเสียงที่ซิงโครไนซ์กัน หากเป็น false จะปิดใช้งานการสร้างเสียง หากละเว้น จะมีค่าเริ่มต้นเป็น true ใช้กับการสร้างทุกโหมดที่รองรับ

ตัวอย่าง: true
input.watermark
booleanไม่ใช่false
ค่าที่รองรับ
true | false

หากเป็น true จะร้องขอการใส่ลายน้ำ AI บนเอาต์พุต หากเป็น false จะขอเอาต์พุตแบบไม่มีลายน้ำ หากละเว้น จะมีค่าเริ่มต้นเป็น false ใช้กับการสร้างทุกโหมดที่รองรับ

ตัวอย่าง: false
input.web_search
booleanไม่ใช่false
ค่าที่รองรับ
true | false

หากเป็น true จะอนุญาตให้ใช้การค้นหาเว็บเมื่อพร้อมใช้งานสำหรับรุ่นนั้นๆ หากเป็น false จะปิดใช้งาน หากละเว้น จะมีค่าเริ่มต้นเป็น false การเปิดใช้งานนี้ไม่ได้การันตีว่าจะมีการดำเนินการค้นหาจริงเสมอไป

ตัวอย่าง: false
input.return_last_frame
booleanไม่ใช่false
ค่าที่รองรับ
true | false

หากเป็น true จะร้องขอเฟรมสุดท้ายของวิดีโอที่สร้างขึ้น หากเป็น false จะไม่ร้องขอ หากละเว้น จะมีค่าเริ่มต้นเป็น false ใช้กับการสร้างทุกโหมดที่รองรับ เมื่อมีการร้องขอและพร้อมใช้งาน URL จะถูกส่งกลับในฟิลด์ data.last_frame_url มิฉะนั้นจะเป็น null

ตัวอย่าง: true
input.seed
integerไม่ใช่—
ค่าที่รองรับ
-1 ถึง 2147483647

จำนวนเต็มตั้งแต่ -1 ถึง 2147483647 โดยค่า -1 จะเป็นการสุ่ม Seed

ตัวอย่าง: 42
input.output_format
stringไม่ใช่mp4
ค่าที่รองรับ
mp4 | mov

mp4 หรือ mov หากละเว้น จะมีค่าเริ่มต้นเป็น mp4 สำหรับเลือกรูปแบบคอนเทนเนอร์ของเอาต์พุตในทุกโหมดการสร้างที่รองรับ

ฟิลด์ประเภทบูลีนต้องระบุค่าเป็น true หรือ false ในรูปแบบ JSON เท่านั้น ห้ามระบุเป็นสตริงหรือตัวเลข

การตอบกลับเมื่อสร้างงาน

HTTP 200 จะส่งคืน taskId (สตริง) และ credits (ตัวเลข) ซึ่งเป็นการยืนยันว่าระบบได้รับงานแล้ว ไม่ใช่หมายความว่างานเสร็จสิ้น จำนวนเครดิตด้านล่างนี้สอดคล้องกับการใช้งานเริ่มต้นด่วนแบบ 720p ความยาว 5 วินาที

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

โหมดการสร้างวิดีโอและตัวอย่าง

โปรดเปลี่ยน URL สื่อของ example.com ให้เป็นไฟล์ HTTPS สาธารณะของคุณเอง URL ตัวอย่างเหล่านี้มีไว้เพื่อแสดงโครงสร้างรีเควสเท่านั้น ไม่ใช่ไฟล์ตัวอย่างที่ดาวน์โหลดได้

ข้อความเป็นวิดีโอ (Text to video)

สร้างวิดีโอจากข้อความพรอมต์ โดย URL สื่อจะไม่ถูกส่งต่อในโหมดนี้

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

เฟรมแรก

ระบุรูปภาพหนึ่งรูปเป็นเฟรมแรก จากนั้นอธิบายการเคลื่อนไหวในพรอมต์ของคุณ

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

เฟรมแรกและเฟรมสุดท้าย

ระบุ URL รูปภาพสองรูปตามลำดับ: เฟรมแรก ตามด้วยเฟรมสุดท้าย ตัวอย่างนี้ยังแสดงการร้องขอเฟรมสุดท้ายของวิดีโอที่สร้างขึ้นด้วย

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

อินพุตแบบมัลติโมดอล

รวมอินพุตอ้างอิงทั้งรูปภาพ วิดีโอ และเสียงเข้าด้วยกัน โดยยังคงต้องระบุพรอมต์เช่นเดิม การส่งวิดีโออ้างอิงจะเปลี่ยนสูตรการคิดค่าบริการ

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

ไฟล์เสียงอ้างอิง

ใช้เสียงเป็นอินพุตอ้างอิงเพียงอย่างเดียว โดยต้องระบุพรอมต์ข้อความเพื่ออธิบายวิดีโอที่ต้องการสร้าง

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

การตัดต่อวิดีโอ

สำหรับการตัดต่อวิดีโอด้วย Seedance 2.5 Flash ต้องตั้งค่า duration เป็น -1 และตั้งค่า aspect_ratio เป็น adaptive เท่านั้น จำเป็นต้องตั้งค่าทั้งสองส่วนนี้ หากไม่ตั้งค่า การสร้างวิดีโอจะล้มเหลว

อธิบายสิ่งที่ต้องการแก้ไขและระบุวิดีโอต้นฉบับ ตั้งค่า duration=-1 และใช้อัตราส่วนภาพแบบ adaptive โปรดใช้คลิปต้นฉบับที่มีความยาวอย่างน้อย 4 วินาทีสำหรับขั้นตอนการทำงานนี้ ดูวิธีคิดราคาของ duration=-1 ได้ที่ด้านบน

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

การต่อความยาววิดีโอ

สำหรับฟังก์ชันการขยายวิดีโอ (video extension) ของ Seedance 2.5 Flash จำเป็นต้องตั้งค่า aspect_ratio เป็น adaptive มิฉะนั้นการสร้างวิดีโออาจล้มเหลว ทั้งนี้ คุณสามารถตั้งค่า duration ตามความยาวของวิดีโอที่ต้องการได้ตามปกติภายในช่วงที่รองรับ โดยไม่จำเป็นต้องใช้ค่า -1

อธิบายว่าต้องการให้วิดีโอต้นฉบับดำเนินเรื่องต่ออย่างไร ใช้อัตราส่วนภาพแบบ adaptive และกำหนดความยาวผลลัพธ์ปกติให้อยู่ในช่วงที่โมเดลรองรับ

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

สืบค้นสถานะงาน

GET https://api.seevio.ai/v1/tasks/{taskId}

แทนที่ ID ตัวอย่างด้วย taskId ที่ได้จากการสร้างงาน การสืบค้นจะแสดงเฉพาะงานที่เป็นของผู้ใช้คีย์ API นั้นๆ เท่านั้น หากเข้าถึงไม่ได้หรือไม่พบ ID จะส่งคืน HTTP 404

ในเบื้องต้นแนะนำให้สืบค้นสถานะทุกๆ 10–20 วินาที หากพบ HTTP 429 ให้เว้นระยะเวลาเพิ่มขึ้น และหยุดสืบค้นเมื่อสถานะเป็น completed หรือ failed แนะนำให้ใช้เว็บฮุกสำหรับสภาพแวดล้อมจริง ตัวอย่างโค้ดด้านล่างนี้แต่ละชุดจะทำการสืบค้นเพียงหนึ่งครั้ง

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"
สถานะคำอธิบายและข้อจำกัด
queuedรับงานแล้วและกำลังรอคิวประมวลผล
generatingกำลังสร้างวิดีโอ
completedเสร็จสมบูรณ์ โปรดดาวน์โหลดไฟล์จาก data.results ก่อนหมดอายุ
failedล้มเหลว โปรดตรวจสอบรายละเอียดใน failed_reason และ billing_status
ฟิลด์ประเภทคำอธิบายและข้อจำกัด
idstring
รหัสระบุงาน ซึ่งก็คือ taskId จากผลการตอบกลับเมื่อสร้างงาน
created_atnumber
เวลาที่สร้างงานในรูปแบบ Unix timestamp (วินาที)
modelstring
ID โมเดลสาธารณะที่ใช้สำหรับงานนี้
billing_statusstring
reserved (สำรองเครดิตแล้ว), charged (หักเครดิตแล้ว), refunded (คืนเครดิตแล้ว) หรือ refund_failed (คืนเครดิตไม่สำเร็จ)
creditsnumber
เครดิตที่สำรองไว้สำหรับงานนี้ ค่านี้จะยังคงอยู่แม้จะมีการคืนเครดิตแล้ว โปรดตรวจสอบที่ billing_status เพื่อดูผลการเรียกเก็บเงินที่แท้จริง
failed_reasonstring | null
สาเหตุความล้มเหลวสำหรับงานที่ล้มเหลว หากงานไม่ล้มเหลวค่าจะเป็น null ผลการสืบค้นของงานที่ล้มเหลวจะไม่มีข้อมูลในฟิลด์ data
dataobject
จะแสดงเมื่อการสืบค้นงานไม่ล้มเหลว โดยประกอบด้วยรายละเอียดผลลัพธ์และขั้นตอนการประมวลผล
data.resultsstring[]
อาร์เรย์ URL ของวิดีโอ จะไม่มีข้อมูลจนกว่างานจะเสร็จสิ้นหรือหลังจากวิดีโอหมดอายุ
data.video_expires_atstring | null
เวลาหมดอายุของวิดีโอในรูปแบบ ISO 8601 หรือเป็น null ก่อนที่วิดีโอจะพร้อมใช้งาน โปรดบันทึกผลลัพธ์ก่อนถึงเวลานี้
data.last_frame_urlstring | null
URL ของเฟรมสุดท้ายเมื่อมีการร้องขอและพร้อมใช้งาน มิฉะนั้นจะเป็น null
data.processing_timenumber | null
ระยะเวลาในการประมวลผลงาน (วินาที) หากไม่มีข้อมูลจะแสดงเป็น null

งานเสร็จสิ้น: ผลลัพธ์การสอบถามพร้อมข้อมูลวิดีโอ

เมื่อสถานะที่ส่งกลับมาเป็น status=completed แสดงว่าการสร้างวิดีโอเสร็จสมบูรณ์แล้ว คุณสามารถดึง URL ของวิดีโอได้จาก data.results และต้องดาวน์โหลดวิดีโอก่อนถึงเวลาที่ระบุใน data.video_expires_at ส่วน billing_status=charged ระบุว่าระบบได้หักเครดิตที่สำรองไว้เรียบร้อยแล้ว

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

งานล้มเหลว: ผลลัพธ์การสอบถามพร้อมสาเหตุและการคืนเครดิต

เมื่อสถานะที่ส่งกลับมาเป็น status=failed แสดงว่าการสร้างวิดีโอไม่สำเร็จ ให้ดูสาเหตุที่ล้มเหลวได้ใน failed_reason และตรวจสอบผลการคืนเครดิตได้จาก billing_status สำหรับตัวอย่างนี้ refunded หมายถึงระบบได้คืนเครดิตให้แล้ว ส่วน credits จะยังคงแสดงจำนวนเดิมที่เคยสำรองไว้ และจะไม่มีการส่งกลับข้อมูลใน data

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed"
}

เว็บฮุก

ตั้งค่า callback_url ในรีเควสการสร้างงานเพื่อรับ JSON POST เมื่อสร้างงานสำเร็จหรือล้มเหลว ระบบปลายทางของคุณต้องส่งการตอบกลับ 2xx กลับมาภายใน 15 วินาที หากส่งไม่สำเร็จระบบจะพยายามส่งซ้ำ โปรดออกแบบระบบรับข้อมูลให้รองรับการทำงานแบบ Idempotent โดยตรวจสอบจาก ID ของงาน

ปลายทางคอลแบ็ก (Callback endpoint) ของคุณต้องรองรับคำขอแบบ POST ที่ส่งข้อมูลมาในรูปแบบ JSON (Content-Type: application/json)

สร้างงานพร้อมกำหนดคอลแบ็ก

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

งานเสร็จสิ้น: ข้อมูล Callback เมื่อทำรายการสำเร็จ

เมื่อสร้างวิดีโอสำเร็จ Callback จะส่งค่า status=completed ให้ใช้ id เพื่อระบุงาน และใช้ data.results เพื่อดึง URL ของวิดีโอ โปรดดาวน์โหลดและบันทึกไฟล์วิดีโอก่อนถึงเวลาที่ระบุใน data.video_expires_at

created_at คือเวลาสร้างเหตุการณ์ ส่วน task_created_at คือเวลาสร้างงาน ทั้งคู่เป็นวินาที Unix ตัวอย่างแสดงฟิลด์ที่แนะนำ โดยข้อมูลตอบกลับอาจมีฟิลด์เพิ่มเติม

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

งานล้มเหลว: ข้อมูล Callback เมื่อทำรายการไม่สำเร็จ

หากการสร้างวิดีโอล้มเหลว Callback จะส่งค่า status=failed ให้ใช้ id เพื่อระบุงาน ใช้ failed_reason เพื่อดูสาเหตุความล้มเหลว และใช้ credits_refunded เพื่อดูจำนวนเครดิตที่คืนให้

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed",
  "credits_refunded": 50
}

ตัวอย่างระบบรับข้อมูล

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

ตัวอย่างการใช้งาน Next.js นี้จะอ่านข้อมูล JSON จาก Callback และจัดการกับสถานะงานที่เสร็จสิ้นหรือล้มเหลวโดยตรง ทั้งนี้ ควรเพิ่มระบบจัดเก็บข้อมูล (Persistence) และระบบป้องกันงานซ้ำ (Task-ID deduplication) สำหรับแอปพลิเคชันของคุณ รวมถึงจัดคิวงานที่ใช้เวลาประมวลผลนานก่อนที่จะตอบรับ (Acknowledge) Callback

ข้อกำหนดและข้อจำกัดของสื่อ

  • URL ของสื่อและคอลแบ็กทั้งหมดต้องเป็น URL HTTPS สาธารณะ หลีกเลี่ยงการใช้ localhost, IP ส่วนตัว และไฟล์ที่ต้องใช้คุกกี้หรือการเข้าสู่ระบบ URL ของวิดีโอ/เสียงอ้างอิงต้องเป็นลิงก์ที่เข้าถึงและอ่านไฟล์สื่อได้โดยตรง
  • ในโหมด reference-to-video ต้องระบุอินพุตอ้างอิงอย่างน้อยหนึ่งรายการ โดยรูปภาพต้องไม่เกิน 30 รูป วิดีโอไม่เกิน 10 วิดีโอ ไฟล์เสียงไม่เกิน 10 ไฟล์ และสื่อรวมกันทั้งหมดต้องไม่เกิน 50 รายการ ความยาวรวมของวิดีโอและไฟล์เสียงต้องไม่เกิน 30 วินาทีสำหรับแต่ละประเภท
  • โหมด text-to-video จะละเว้นสื่ออ้างอิงทั้งหมด โหมด image-to-video จะส่งต่อเฉพาะรูปภาพเฟรมแรก/เฟรมสุดท้ายและละเว้นวิดีโอและเสียงอ้างอิง โปรดใช้โหมด reference-to-video หากต้องการรวมสื่อหลายประเภท
  • วิดีโอและไฟล์เสียงอ้างอิงแต่ละไฟล์ต้องมีความยาว 2–30 วินาที สำหรับการตัดต่อวิดีโอ โปรดใช้คลิปต้นฉบับที่มีความยาวอย่างน้อย 4 วินาที

ข้อกำหนดสำหรับรูปภาพ

  • รูปภาพแต่ละไฟล์ต้องมีขนาดไม่เกิน 30 MB
  • รูปแบบไฟล์ที่รองรับ: jpeg, png, webp, bmp, tiff, gif
  • อัตราส่วนภาพ (ความกว้าง ÷ ความสูง): ระหว่าง 0.4 ถึง 2.5
  • ความกว้างและความสูงต้องอยู่ระหว่าง 300 ถึง 6,000 พิกเซล

ข้อกำหนดสำหรับวิดีโอ

  • รูปแบบไฟล์ที่รองรับ: mp4, mov
  • วิดีโอแต่ละไฟล์ต้องมีขนาดไม่เกิน 100 MB
  • อัตราเฟรมเรต: 24 ถึง 60 FPS
  • อัตราส่วนภาพ (ความกว้าง ÷ ความสูง): ระหว่าง 0.4 ถึง 2.5
  • จำนวนพิกเซลทั้งหมด (ความกว้าง × ความสูง): ระหว่าง 407,696 ถึง 8,295,044 พิกเซล ตัวอย่างเช่น 614 × 664 = 407,696 และ 3,326 × 2,494 = 8,295,044 (ตัวเลขนี้เป็นเพียงตัวอย่างการคำนวณจำนวนพิกเซล ไม่ใช่ข้อบังคับสำหรับความกว้างและความสูงจริง)

ข้อกำหนดสำหรับไฟล์เสียง

  • รูปแบบไฟล์ที่รองรับ: wav, mp3
  • ไฟล์เสียงแต่ละไฟล์ต้องมีขนาดไม่เกิน 15 MB