ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro สร้างวิดีโอไม่มีเสียงจากข้อความหรือภาพเปิด บรรยายการกระทำและกล้อง หรือทำให้องค์ประกอบภาพที่มีอยู่เคลื่อนไหว โดยมีความยาว 2–12 วินาที อัตราเฟรม 24 fps และตัวควบคุมการจัดเฟรมกับความละเอียดผลลัพธ์ที่ระบุชัดเจน

Ailoot Ultra · วิดีโอ POST /v1/videos doubao-seedance-1-0-pro-250528

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

Seedance 1.0 Pro สร้างวิดีโอจากข้อความหรือฉากที่ใช้ภาพนำทาง ตัวเลือก doubao-seedance-1-0-pro-250528 รองรับทั้งสองโหมดอินพุต จึงเริ่มจากแนวคิดที่เขียนไว้หรือองค์ประกอบภาพที่มีอยู่ได้ ใช้บรีฟข้อความเพื่อสร้างฉากใหม่ หรือส่งภาพเมื่อต้องการให้ภาพกำหนดตัวแบบ การจัดวาง และมุมมองเปิด โปรไฟล์ 1.0 นี้สร้างวิดีโอไม่มีเสียง ส่วนเสียงที่สัมพันธ์กับภาพเป็นความสามารถของโปรไฟล์ 1.5 Pro ซึ่งอธิบายแยกไว้

สำหรับข้อความเป็นวิดีโอ ให้ระบุตัวแบบ สภาพแวดล้อม การเคลื่อนไหว การจัดเฟรม และกล้องเป็นฉากที่ต่อเนื่องกัน ตัวอย่างในเอกสารค่อย ๆ เคลื่อนจากทุ่งดอกเดซี่ไปยังภาพใกล้ของดอกไม้ที่มีหยดน้ำค้างบนกลีบ โครงสร้างนี้ใช้กับการเผยรายละเอียดอื่นได้เช่นกัน: เริ่มจากสถานที่ เคลื่อนเข้าหาตัวแบบ และจบที่รายละเอียดสำคัญ สำหรับแนวคิดผลิตภัณฑ์ ให้บรรยายวัสดุและแสงนอกเหนือจากการกระทำ และกำหนดเส้นทางกล้องที่ทำได้ภายในช็อตสั้น

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

ฟิลด์ภาพรับ URL ที่เข้าถึงได้ หรือ data URL ที่บรรจุข้อมูลภาพ Base64 รูปแบบตามเอกสาร ได้แก่ JPEG, PNG, WEBP, BMP, TIFF และ GIF ภาพต้องมีขนาดเล็กกว่า 30 MB อัตราส่วนความกว้างต่อความสูงต้องมากกว่า 0.4 และน้อยกว่า 2.5 และแต่ละด้านต้องมากกว่า 300 และน้อยกว่า 6000 พิกเซล เตรียมภาพต้นทางที่ชัดเจนและครอปตรงตามต้องการ แทนการพึ่งภาพย่อที่ขาดรายละเอียดสำคัญอยู่แล้ว สำหรับภาพเป็นวิดีโอ คู่มือแนะนำการจัดเฟรมแบบ adaptive เพื่อให้สอดคล้องกับสัดส่วนภาพอ้างอิง

ความยาวของ 1.0 ตามเอกสารคือสองถึงสิบสองวินาที และอัตราเฟรมคือ 24 fps ตัวควบคุมผลลัพธ์มีระดับ 480p, 720p และ 1080p โดยค่าเริ่มต้นของ Pro คือ 1080p แต่คู่มือไม่รองรับ 1080p ในกรณีใช้ภาพอ้างอิง รูปร่างเฟรมคงที่ ได้แก่ 16:9, 4:3, 1:1, 3:4, 9:16 และ 21:9 เลือกชุดค่าที่รองรับภาพสำหรับช็อตที่ใช้ภาพนำทาง แทนการย้ายค่าข้อความเป็นวิดีโอทุกค่าไปใช้โดยไม่เปลี่ยนแปลง ตรวจการจัดเฟรมที่ส่งกลับจริงก่อนนำคลิปไปวางในเลย์เอาต์

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

ปริมาณการใช้งานวัดเป็นโทเคนวิดีโอ: ความกว้างผลลัพธ์ × ความสูงผลลัพธ์ × อัตราเฟรม × ความยาวผลลัพธ์ / 1024 งานที่เสร็จแล้วรายงานปริมาณนี้ใน usage.completion_tokens เก็บปริมาณที่รายงานไว้พร้อมคลิปสำเร็จและการตั้งค่าที่ร้องขอ

ขั้นตอนนี้ส่งรหัสงานกลับมาก่อน และให้ตำแหน่งวิดีโอสำเร็จหลังประมวลผล เก็บรหัสไว้ระหว่างตรวจสถานะ queued หรือ running งานที่มีสถานะ succeeded จะให้ content.video_url และข้อมูลการใช้งาน ระยะเวลาเก็บไฟล์ที่สร้างตามเอกสารคือเจ็ดวัน บันทึกคลิปสำเร็จ ภาพต้นทาง และพรอมป์ต์ตรงตามที่ใช้เป็นประวัติการแก้ไข จากนั้นตรวจรูปลักษณ์ตัวแบบ การเคลื่อนไหว ความต่อเนื่องจากภาพ และองค์ประกอบภาพปิดตลอดทั้งผลลัพธ์

Ailoot Ultra · วิดีโอ POST /v1/videos doubao-seedance-1-0-pro-250528

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

เริ่มต้น

อินพุตที่รองรับ: ข้อความ · รูปภาพ
ผลลัพธ์: วิดีโอ

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · วิดีโอ POST /v1/videos

ขาเข้า: text, image
ขาออก: video

ฟิลด์	ประเภท	ข้อกำหนด	ค่าและข้อจำกัด	ค่าเริ่มต้น
ฟิลด์`model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด doubao-seedance-1-0-pro-250528	ค่าเริ่มต้น—
ฟิลด์`content`	ประเภท`array`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด เงื่อนไข: ออบเจ็กต์ข้อความ/สื่อในรูปแบบดั้งเดิม อาร์เรย์ชั้นนอกต้องไม่ว่าง ตัวสร้างทั่วไปของ Ailoot นี้ไม่ตรวจสอบชนิดของโหนดที่ซ้อนอยู่	ค่าเริ่มต้น—
ฟิลด์`duration`	ประเภท`integer`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด ขั้นต่ำ: 2 สูงสุด: 12 เงื่อนไข: สคีมาหลักของ 1.x ระบุ 2–12 คำอธิบายที่ใช้ร่วมกันในภายหลังระบุ 1.5 เป็น 4–12 หรือ -1 ตัวอย่างใช้ 5 ซึ่งมีระบุสอดคล้องกันในเอกสารทั้งสองส่วน	ค่าเริ่มต้น5
ฟิลด์`resolution`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด เงื่อนไข: ค่าที่ได้รับการยืนยันสำหรับข้อความเป็นวิดีโอคือ 480p และ 1080p ข้อมูลขาเข้าภาพอ้างอิงไม่รองรับ 1080p ค่า enum 720p ที่ใช้ร่วมกันขัดกับคำอธิบายเฉพาะโมเดล จึงยังไม่มีข้อสรุปเรื่องการรองรับ 720p ในทั้งสองโหมด	ค่าเริ่มต้น1080p
ฟิลด์`ratio`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive เงื่อนไข: ค่าเริ่มต้นขึ้นกับฉาก/โมเดล เอกสารข้อมูลขาเข้าภาพแนะนำ adaptive	ค่าเริ่มต้น—
ฟิลด์`service_tier`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด default, flex เงื่อนไข: default=online, flex=offline เลือกก่อนสร้าง	ค่าเริ่มต้นdefault
ฟิลด์`seed`	ประเภท`integer`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด ขั้นต่ำ: -1 สูงสุด: 4,294,967,295	ค่าเริ่มต้น-1
ฟิลด์`camerafixed`	ประเภท`boolean`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด เงื่อนไข: Ailoot กำหนดให้ต้องระบุ เอกสารระบุว่าไม่รองรับการควบคุมกล้องด้วยภาพอ้างอิง และไม่รับประกันผล	ค่าเริ่มต้นfalse
ฟิลด์`watermark`	ประเภท`boolean`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด	ค่าเริ่มต้นfalse
ฟิลด์`execution_expires_after`	ประเภท`integer`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด ขั้นต่ำ: 3,600 สูงสุด: 259,200 หน่วย: วินาที	ค่าเริ่มต้น172,800

ชุดผสมของสื่ออินพุต

พารามิเตอร์และวงจรการทำงานของเมธอด

พารามิเตอร์	ข้อกำหนด
พารามิเตอร์`content_type`	ข้อกำหนดapplication/json
พารามิเตอร์`required`	ข้อกำหนดcamerafixed, content, execution_expires_after, model, seed, watermark
พารามิเตอร์`optional`	ข้อกำหนดduration, resolution, ratio, service_tier
พารามิเตอร์`material_types`	ข้อกำหนดtext, image
พารามิเตอร์`additional_properties`	ข้อกำหนดtrue
พารามิเตอร์`validation_scope`	ข้อกำหนดAiloot ตรวจสอบชนิดของฟิลด์ที่จำเป็นและ model/อาร์เรย์ content ที่ไม่ว่าง ฟิลด์อื่นของคำขอจะถูกคงไว้สำหรับโมเดลที่เลือก
พารามิเตอร์`image_constraints`	ข้อกำหนด{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null}

ชื่ออื่นของเมธอด: /v1/videos/generations

วงจรการทำงาน: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

สร้างเพียงครั้งเดียวและเก็บ id/polling_url สาธารณะที่ส่งกลับ

ตรวจสอบงานเดิมเป็นระยะ ดาวน์โหลด content.video_url จริงที่เป็นของคุณหลังสถานะ succeeded

ราคา

วิธีคำนวณค่าบริการสุดท้าย

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

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว: ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น: ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด: ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน

การตั้งค่า	ตารางอัตราค่าบริการ	ปริมาณคาดการณ์	หน่วยคิดค่าบริการ	ค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน	ตารางอัตราค่าบริการอัตราพื้นฐาน	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการ—	ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าUltra	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการต่อ 1K โทเค็นวิดีโอ	ค่าบริการ ขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.0044 ต่อ 1K โทเค็นวิดีโอ
การตั้งค่าต้นทุนการสร้างโดยประมาณ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง	หน่วยคิดค่าบริการ—	ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.2112 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

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

ตัวอย่างคำขอ

Ailoot Ultra · วิดีโอ

curl · สร้างวิดีโอcurl · อ่านข้อมูลงานต้นฉบับcurl · ดาวน์โหลดวิดีโอที่เป็นของคุณ

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
    if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
    p=urlsplit(u)
    if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
  index=$((index + 1))
done < asset-urls.txt

รับและบันทึกผลลัพธ์

Ailoot Ultra · วิดีโอ

JSON ดั้งเดิมพร้อม id/polling_url สาธารณะ หลังเผยแพร่ content.video_url มี URL ที่ลงลายเซ็นและเป็นของ Ailoot ก่อนเผยแพร่ URL ผลลัพธ์ที่เลือกจะถูกทำให้ว่าง

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

บันทึกวิดีโอที่สร้างเสร็จหรือไฟล์ที่ส่งกลับมาทุกไฟล์ และดึงไฟล์สื่อจากทุก URL ที่ส่งกลับมาจริง

เก็บ URL จริงทุกรายการใน content.video_url โดย index ต้องระบุผลลัพธ์จริงที่ส่งกลับ

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

เก็บการตอบกลับ/ส่วนหัว/id เดิมและตรวจสอบการดำเนินการนั้นเป็นระยะ ห้ามส่งคำขอสร้างที่ยังไม่ทราบผลซ้ำ

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท
ฟิลด์`id`	ประเภทstring
ฟิลด์`provider_task_id`	ประเภทstring
ฟิลด์`polling_url`	ประเภทstring
ฟิลด์`status`	ประเภทstring when supplied
ฟิลด์`content.video_url`	ประเภทstring\|string[]
ฟิลด์`usage`	ประเภทobject when supplied

ข้อผิดพลาดและขั้นตอนถัดไป

การตอบกลับ	เงื่อนไข	ขั้นตอนถัดไป
การตอบกลับ400 · `invalid_request_error`	เงื่อนไขJSON/โมเดล/ชนิดฟิลด์ที่จำเป็น หรือดัชนีเนื้อหาไม่ถูกต้อง	ขั้นตอนถัดไป
การตอบกลับ401 · `authentication_error`	เงื่อนไขคีย์ API ของ Ailoot ไม่ถูกต้อง	ขั้นตอนถัดไป
การตอบกลับ404 · `not_found_error`	เงื่อนไขไม่พบงาน/ผลลัพธ์ หรือไม่ได้เป็นของผู้ใช้/คีย์ API/กลุ่มเดียวกัน	ขั้นตอนถัดไป
การตอบกลับ502 · `result_pending_check`	เงื่อนไขการส่งคำขอ/สถานะเดิมไม่สมบูรณ์ เก็บ ID เดิม ห้ามส่งซ้ำ	ขั้นตอนถัดไป
การตอบกลับ503 · `result_pending_check`	เงื่อนไขกำลังตรวจสอบสื่อ/เส้นทาง/การชำระบัญชีเดิม ให้ดำเนินการเดิมต่อ	ขั้นตอนถัดไป

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra doubao-seedance-1-0-pro-250528

ชื่อพาธเมธอดอื่น

/v1/videos/generations

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

มีอินพุตและผลลัพธ์ใดบ้าง?: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
คำขอใช้ฟิลด์ใดบ้าง?: POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
มีข้อจำกัดใดบ้าง?: POST /v1/videos · doubao-seedance-1-0-pro-250528: duration.minimum: 2; duration.maximum: 12; seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 1.0 Pro