ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast เป็นโปรไฟล์ Fast ที่มีชื่อแยกต่างหากสำหรับสร้างวิดีโอไม่มีเสียงจากข้อความและจากภาพ รับบรีฟฉากหรือองค์ประกอบภาพที่ใช้ภาพนำทาง โดยมีผลลัพธ์ยาว 2–12 วินาที อัตราเฟรม 24 fps และตัวควบคุมการจัดเฟรมที่ระบุชัดเจน
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Seedance 1.0 Pro Fast เป็นโปรไฟล์ Fast ที่ระบุด้วย doubao-seedance-1-0-pro-fast-251015 สร้างวิดีโอไม่มีเสียงจากคำบรรยายฉากหรือองค์ประกอบภาพเริ่มต้นที่ใช้ภาพนำทาง ตัวเลือกตรงตามชื่อนี้แยกโปรไฟล์ออกจาก Seedance 1.0 Pro โดยคำว่า Fast ไม่ได้กำหนดเวลาที่รับประกันว่างานแต่ละชิ้นจะเสร็จ เลือกโหมดอินพุตตามสิ่งที่จะใช้กำหนดฉาก แล้วประเมินคลิปที่ส่งกลับเทียบกับบรีฟนั้น
ช็อตที่ใช้ข้อความนำเริ่มจากลำดับที่กระชับ: ตัวแบบและสถานที่ การกระทำ เส้นทางกล้อง และมุมมองสุดท้าย สำหรับการเผยผลิตภัณฑ์ ให้บรรยายวัตถุบนพื้นผิว แสงบนวัสดุ และการเคลื่อนไหวสั้น ๆ ที่จบตรงลักษณะที่ต้องการแสดง สำหรับแนวคิดสถานที่ ให้เคลื่อนจากภาพกว้างที่แนะนำสถานที่ไปยังจุดเด่นที่จำได้ หลีกเลี่ยงการให้คลิปสั้นคลิปเดียวทำหลายฉากที่ไม่เกี่ยวกัน ซึ่งต้องแนะนำตัวแบบและสถานที่ทั้งหมดใหม่ตั้งแต่ต้น
ช็อตที่ใช้ภาพนำเริ่มจากรายการ image_url ในอาร์เรย์ content และคำสั่งข้อความสำหรับการเคลื่อนไหว เตรียมการครอป ฉากหลัง และการจัดวางตัวแบบในภาพ แล้วระบุว่าองค์ประกอบใดเคลื่อนและกล้องทำงานอย่างไร วิธีนี้ทำให้องค์ประกอบภาพนิ่งกลายเป็นฉากเคลื่อนไหวสั้นได้ เหมาะกับภาพบุคคล วัตถุบนโต๊ะ หรือแนวคิดภาพที่เตรียมไว้ แต่ยังต้องตรวจอัตลักษณ์ รูปทรง และการเคลื่อนไหวของผลลัพธ์จริงตลอดคลิป
ภาพอินพุตอาจใช้ URL ที่เข้าถึงได้หรือ Base64 data URL รูปแบบที่ระบุในเอกสารคือ JPEG, PNG, WEBP, BMP, TIFF และ GIF ภาพต้องเล็กกว่า 30 MB ทั้งสองด้านต้องมากกว่า 300 และน้อยกว่า 6000 พิกเซล และความกว้างหารความสูงต้องมากกว่า 0.4 และน้อยกว่า 2.5 เลือกภาพต้นทางที่สะอาดและเห็นรายละเอียดตัวแบบ คู่มือภาพแนะนำการจัดเฟรมแบบ adaptive ดังนั้นสัดส่วนภาพที่เตรียมควรตรงกับองค์ประกอบภาพที่ต้องการทำให้เคลื่อนไหว
โปรไฟล์ 1.0 ระบุความยาวสองถึงสิบสองวินาทีที่ 24 fps Pro Fast มีความละเอียดเริ่มต้น 1080p และตารางผลลัพธ์ที่เก็บไว้แสดงระดับ 480p, 720p และ 1080p คู่มือการใช้งานไม่รองรับ 1080p ในกรณีใช้ภาพอ้างอิง อัตราส่วนภาพคงที่ ได้แก่ 16:9, 4:3, 1:1, 3:4, 9:16 และ 21:9 เลือกความละเอียดและรูปร่างเฟรมให้เหมาะกับโหมดอินพุตที่เลือก แทนการคิดว่าทุกชุดค่าใช้แทนกันได้
ตัวเลือกซีดและลายน้ำช่วยให้การตั้งค่าคำขอชัดเจน ค่าซีดจำนวนเต็มมีช่วง -1 ถึง 2^32-1 โดย -1 ขอให้ใช้ค่าสุ่ม คำสั่งตรึงกล้องมีเงื่อนไข: คู่มือไม่รองรับกรณีภาพอ้างอิง และไม่รับประกันผลทางภาพในกรณีที่รองรับ คำสั่งพารามิเตอร์ที่ฝังในข้อความทับพารามิเตอร์เสริมที่แยกไว้ ให้คำสั่งเหล่านั้นสอดคล้องกัน โดยเฉพาะเมื่อแก้พรอมป์ต์ซึ่งอาจยังมีคำสั่งความยาวหรือความละเอียดเดิมหลงเหลืออยู่ในคำบรรยายฉาก
ปริมาณการใช้งานวัดเป็นโทเคนวิดีโอ: ความกว้างผลลัพธ์ × ความสูงผลลัพธ์ × อัตราเฟรม × ความยาวผลลัพธ์ / 1024 งานที่เสร็จแล้วรายงานปริมาณนี้ใน usage.completion_tokens เก็บปริมาณที่รายงานไว้พร้อมคลิปสำเร็จและการตั้งค่าที่ร้องขอ
การส่งคำขอสร้างงานแบบอะซิงโครนัส บันทึกรหัสงาน ติดตามสถานะ และรับวิดีโอสำเร็จจาก content.video_url หลังสำเร็จ เอกสารระบุว่าเก็บไฟล์ที่สร้างไว้เจ็ดวัน จึงควรเก็บชิ้นงานสำเร็จพร้อมพรอมป์ต์และภาพอินพุตที่ใช้ ตรวจการกระทำทั้งหมด การเคลื่อนกล้อง และการจัดเฟรมสุดท้าย หากรายละเอียดหนึ่งไม่ตรงบรีฟ ให้บรรยายการแก้ไขนั้นโดยเจาะจง พร้อมเก็บส่วนที่ได้ผลไว้
Ailoot Ultra · วิดีโอ POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015เริ่มต้น
Seedance 1.0 Pro Fast เป็นโปรไฟล์ Fast ที่มีชื่อแยกต่างหากสำหรับสร้างวิดีโอไม่มีเสียงจากข้อความและจากภาพ รับบรีฟฉากหรือองค์ประกอบภาพที่ใช้ภาพนำทาง โดยมีผลลัพธ์ยาว 2–12 วินาที อัตราเฟรม 24 fps และตัวควบคุมการจัดเฟรมที่ระบุชัดเจน
- อินพุตที่รองรับ
- ข้อความ · รูปภาพ
- ผลลัพธ์
- วิดีโอ
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · วิดีโอ POST /v1/videos
- ขาเข้า
text,image- ขาออก
video
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด doubao-seedance-1-0-pro-fast-251015 | ค่าเริ่มต้น— |
ฟิลด์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.0012 ต่อ 1K โทเค็นวิดีโอ |
| การตั้งค่าต้นทุนการสร้างโดยประมาณ | ตารางอัตราค่าบริการ— | ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง | หน่วยคิดค่าบริการ— | ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.0576 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว |
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
ตัวอย่างคำขอ
Ailoot Ultra · วิดีโอ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","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}/contentGET /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-fast-251015
ชื่อพาธเมธอดอื่น
/v1/videos/generations
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · ByteDance: Seedance 1.0 Pro Fast
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- มีข้อจำกัดใดบ้าง?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200