วิธีใช้ Seedance 2.0 API ปี 2026

สรุปสั้นๆ

API ของ Seedance 2.0 เปิดตัวเมื่อวันที่ 2 เมษายน 2026 ผ่าน Volcengine Ark คุณสามารถส่งงานสร้างวิดีโอด้วยคำขอ POST จากนั้นตรวจสอบสถานะ (poll) จากปลายทาง GET จนกว่าสถานะจะถึง "succeeded" API รองรับ Text-to-video, Image-to-video, การควบคุมเฟรมเริ่มต้นและเฟรมสุดท้าย, การอ้างอิงแบบหลากหลายสื่อ (multimodal references) และการสร้างเสียงแบบ native วิดีโอ 1080p ความยาว 5 วินาทีมีค่าใช้จ่ายประมาณ $0.93 ดาวน์โหลดวิดีโอภายใน 24 ชั่วโมง URL จะหมดอายุหลังจากนั้น

Hypereal AI

ลองใช้ Hypereal AI

บทนำ

เมื่อวันที่ 2 เมษายน 2026 แพลตฟอร์ม Volcengine Ark ของ ByteDance ได้เปิดตัว API อย่างเป็นทางการของ Seedance 2.0 ก่อนหน้านั้น วิธีเดียวในการสร้างวิดีโอ Seedance 2.0 คือผ่านเว็บคอนโซล หากคุณเคยเห็นบทเรียนที่แสดงการใช้งาน UI วิดีโอเหล่านั้นเขียนขึ้นสำหรับคอนโซลนี้ แต่คู่มือนี้จะครอบคลุม API จริงที่นักพัฒนาสามารถเรียกใช้ด้วยโปรแกรมได้

💡

API ใช้รูปแบบงานแบบ asynchronous: POST เพื่อสร้างงาน, รับ ID ของงาน, จากนั้น poll ปลายทาง GET จนกว่างานจะเสร็จสิ้น รูปแบบนี้คุ้มค่าที่จะทดสอบแบบ end-to-end ก่อนที่คุณจะนำไปใช้งานจริง Test Scenarios ของ Apidog ช่วยให้คุณสามารถเชื่อมโยงการส่ง POST, ดึง ID ของงาน, วนซ้ำการ poll ด้วย GET และยืนยันว่าการตอบกลับสุดท้ายมี URL วิดีโอที่ถูกต้อง ดาวน์โหลด Apidog ฟรีเพื่อทำตามขั้นตอนการทดสอบในส่วน Apidog ด้านล่าง

บทความนี้ครอบคลุมประเภทอินพุตที่รองรับทั้งหมด, การคำนวณราคาจากจำนวนโทเค็นในการตอบกลับ และข้อผิดพลาดที่คุณอาจพบในการใช้งานจริง

Seedance 2.0 คืออะไร?

Seedance 2.0 คือโมเดลการสร้างวิดีโอจาก ByteDance มันทำงานบน Volcengine Ark ภายใต้ ID โมเดล doubao-seedance-2-0-260128 (มาตรฐาน) และ doubao-seedance-2-0-fast-260128 (เร็วกว่า คุณภาพต่ำกว่า)

โมเดลรองรับประเภทอินพุตที่มากกว่าเวอร์ชัน 1.5 เวอร์ชัน 1.5 รองรับ Text-to-video และ Image-to-video เวอร์ชัน 2.0 เพิ่ม:

การควบคุมเฟรมแรกและเฟรมสุดท้าย (คุณระบุภาพเริ่มต้นและสิ้นสุดทั้งสองภาพ)
อินพุตอ้างอิงแบบหลากหลายสื่อ: รูปภาพ, คลิปวิดีโอ และไฟล์เสียงรวมกันในคำขอเดียว
การสร้างเสียงแบบ native รวมถึงบทสนทนา, เอฟเฟกต์เสียง, เสียงบรรยากาศ และเพลง
การซิงค์ริมฝีปากในกว่า 8 ภาษา
การควบคุมการเคลื่อนไหวของกล้องผ่านข้อความสั่งภาษาธรรมชาติ (dolly, tracking, crane shots)
เอาต์พุตสูงสุด 15 วินาที ที่ความละเอียดสูงสุด 2K

โมเดลจะส่งออกวิดีโอ 24 fps ที่อัตราส่วนภาพตั้งแต่ 1:1 ถึง 21:9 คุณสามารถเลือกความละเอียดได้ในขณะส่งคำขอ

มีอะไรเปลี่ยนแปลง: คู่มือเทียบกับ API อย่างเป็นทางการ

บทความก่อนหน้านี้เกี่ยวกับ Seedance 2.0 รวมถึง คู่มือเดือนกุมภาพันธ์ 2026 บนเว็บไซต์นี้ อธิบายถึง Seedance 2.0 web console บน Volcengine ณ จุดนั้นยังไม่มี API คำแนะนำเหล่านั้นอธิบายการกรอกช่อง prompt บนหน้าเว็บและคลิกปุ่มสร้าง

การเปิดตัว API เมื่อวันที่ 2 เมษายน 2026 ได้เปลี่ยนแปลงสิ่งนี้ไปอย่างสิ้นเชิง ตอนนี้คุณสามารถเรียกใช้ API จากภาษาใดก็ได้, ทำให้กระบวนการสร้างวิดีโอเป็นอัตโนมัติ และรวม Seedance เข้ากับผลิตภัณฑ์ของคุณเองได้ คู่มือนี้จะมาแทนที่คำแนะนำการใช้งาน UI สำหรับกรณีการใช้งานของนักพัฒนาทุกคน

สิ่งที่ต้องมีก่อนใช้งาน

คุณต้องมีบัญชี Volcengine เพื่อเริ่มต้น สร้างบัญชีได้ที่ volcengine.com เมื่อบัญชีของคุณเปิดใช้งานแล้ว ให้ไปที่คอนโซล Ark ที่:

https://console.volcengine.com/ark/region:ark+cn-beijing/apikey

สร้างคีย์ API ที่นั่น จากนั้นส่งออกเป็นตัวแปรสภาพแวดล้อม:

export ARK_API_KEY="your-api-key-here"

ทุกคำขอไปยัง API จะใช้คีย์นี้ในส่วนหัว Bearer token:

Authorization: Bearer YOUR_ARK_API_KEY

บัญชีใหม่จะได้รับเครดิตทดลองใช้ฟรี ซึ่งครอบคลุมการสร้างวิดีโอ 15 วินาทีแบบเต็มประมาณ 8 ครั้งที่ความละเอียด 1080p ก่อนที่คุณจะต้องชำระเงิน

Text-to-video: คำขอแรกของคุณ

URL พื้นฐานสำหรับการเรียกใช้ Seedance API ทั้งหมดคือ:

https://ark.cn-beijing.volces.com/api/v3

หากต้องการส่งงาน Text-to-video ให้ใช้ POST ไปยัง /v1/contents/generations/tasks

ตัวอย่าง cURL

curl -X POST "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
      }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

API จะคืนค่า task ID ทันที:

{"id": "cgt-2025xxxxxxxx-xxxx"}

ตัวอย่าง Python (SDK อย่างเป็นทางการ)

ติดตั้ง SDK ก่อน:

pip install volcenginesdkarkruntime

จากนั้นส่งงาน:

import os
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

print(resp.id)

เก็บ task ID ไว้ คุณจะต้องใช้มันสำหรับขั้นตอนการตรวจสอบสถานะ

รูปแบบงานแบบ Asynchronous: ส่ง, ตรวจสอบสถานะ, ดาวน์โหลด

การสร้างวิดีโอด้วย Seedance ไม่ได้เกิดขึ้นทันที วิดีโอ 1080p ความยาว 5 วินาที โดยทั่วไปจะใช้เวลา 60 ถึง 120 วินาที API จัดการสิ่งนี้ด้วยวงจรชีวิตของงานแบบ asynchronous:

queued -> running -> succeeded
                  -> failed
                  -> expired
                  -> cancelled

คุณจะต้องตรวจสอบสถานะจากปลายทาง GET จนกว่าสถานะจะเปลี่ยนจาก queued หรือ running

ลูปการตรวจสอบสถานะ Python แบบเต็ม

import os
import time
import requests
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

# Step 1: submit
resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {"type": "text", "text": "Aerial shot of a mountain lake at sunrise, slow dolly forward"}
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

task_id = resp.id
print(f"Task submitted: {task_id}")

# Step 2: poll with exponential backoff
wait = 10
while True:
    result = client.content_generation.tasks.get(task_id=task_id)
    status = result.status
    print(f"Status: {status}")

    if status == "succeeded":
        video_url = result.content.video_url
        print(f"Video URL: {video_url}")
        break
    elif status in ("failed", "expired", "cancelled"):
        print(f"Task ended with status: {status}")
        break

    time.sleep(wait)
    wait = min(wait * 2, 60)  # cap at 60 seconds

# Step 3: download immediately
if status == "succeeded":
    response = requests.get(video_url, stream=True)
    with open("output.mp4", "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)
    print("Downloaded: output.mp4")

การใช้ exponential backoff ช่วยป้องกันการส่งคำขอไปยัง API มากเกินไป การจำกัดเวลาสูงสุดที่ 60 วินาทีช่วยให้การตรวจสอบสถานะบ่อยพอสำหรับการใช้งานจริง

Image-to-video (I2V): การสร้างแอนิเมชันจากภาพนิ่ง

หากต้องการสร้างแอนิเมชันจากรูปภาพ ให้เพิ่มอ็อบเจกต์ image_url ไปยังอาร์เรย์ content พร้อมกับข้อความสั่ง (text prompt) รูปภาพจะกลายเป็นเฟรมแรกของวิดีโอ

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The woman slowly turns her head and smiles at the camera"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/portrait.jpg"}
        }
    ],
    ratio="adaptive",
    duration=5,
    watermark=False,
)

การตั้งค่า ratio เป็น "adaptive" จะบอกให้โมเดลใช้อัตราส่วนภาพดั้งเดิมของรูปภาพอินพุต ซึ่งจะช่วยหลีกเลี่ยงการครอบตัดที่ไม่ต้องการหรือขอบดำ

แต่ละภาพต้องมีขนาดไม่เกิน 30MB คุณสามารถระบุได้สูงสุด 9 ภาพในคำขอเดียว

เฟรมแรกและเฟรมสุดท้าย: ควบคุมจุดเริ่มต้นและจุดสิ้นสุด

Seedance 2.0 รองรับการควบคุมเฟรมเริ่มต้นและสิ้นสุด คุณระบุภาพเฟรมแรก, ภาพเฟรมสุดท้าย และข้อความสั่ง โมเดลจะสร้างการเคลื่อนไหวระหว่างกลาง

สิ่งนี้มีประโยชน์สำหรับการเปลี่ยนฉากสินค้า, เอฟเฟกต์การเปลี่ยนรูป หรือลำดับใดๆ ที่คุณทราบสถานะเริ่มต้นและสิ้นสุด

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The flower blooms from bud to full open, macro lens, soft light"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-bud.jpg"}
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-open.jpg"}
        }
    ],
    ratio="adaptive",
    duration=8,
    watermark=False,
)

โมเดลจะอนุมานว่ารูปภาพสองรูปหมายถึงโหมดเฟรมแรกและเฟรมสุดท้ายเมื่อมีข้อความสั่ง (text prompt) อยู่ด้วย ใส่รูปภาพทั้งสองตามลำดับ: เฟรมแรกก่อน, เฟรมสุดท้ายทีหลัง

คุณยังสามารถใช้ return_last_frame: true เมื่อสร้างคลิป ซึ่งจะคืนภาพของเฟรมสุดท้ายพร้อมกับ URL ของวิดีโอ ส่งภาพนั้นเป็นเฟรมแรกของคำขอถัดไปเพื่อเชื่อมโยงหลายคลิปเข้าด้วยกันให้เป็นลำดับที่ยาวขึ้น

การอ้างอิงแบบหลากหลายสื่อ: การรวมรูปภาพ, วิดีโอ และเสียง

หนึ่งในคุณสมบัติที่แข็งแกร่งที่สุดที่เพิ่มเข้ามาใน Seedance 2.0 คือการยอมรับวิดีโอและเสียงเป็นอินพุตอ้างอิงในคำขอเดียวกับรูปภาพและข้อความ

อาร์เรย์ content สามารถเก็บค่าได้ดังนี้:

{"type": "text", "text": "..."} สำหรับข้อความสั่ง
{"type": "image_url", "image_url": {"url": "..."}} สำหรับรูปภาพ
{"type": "video_url", "video_url": {"url": "..."}} สำหรับการอ้างอิงวิดีโอ
{"type": "audio_url", "audio_url": {"url": "..."}} สำหรับการอ้างอิงเสียง

ข้อจำกัดต่อคำขอ:

รูปภาพสูงสุด 9 ภาพ (แต่ละภาพสูงสุด 30MB)
คลิปวิดีโอสูงสุด 3 คลิป (แต่ละคลิปยาว 2 ถึง 15 วินาที, แต่ละคลิปสูงสุด 50MB)
ไฟล์เสียงสูงสุด 3 ไฟล์ (MP3, แต่ละไฟล์สูงสุด 15MB)

ตัวอย่างการอ้างอิงแบบรวม:

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "Match the visual style of the reference clip and add the provided background audio"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/style-reference.jpg"}
        },
        {
            "type": "video_url",
            "video_url": {"url": "https://example.com/motion-reference.mp4"}
        },
        {
            "type": "audio_url",
            "audio_url": {"url": "https://example.com/background-music.mp3"}
        }
    ],
    duration=10,
    ratio="16:9",
    watermark=False,
)

เมื่อคุณรวมการอ้างอิงวิดีโอ อัตราค่าบริการจะลดลงเป็นระดับ V2V: ประมาณ $3.90 ต่อล้านโทเค็น แทนที่จะเป็น $6.40

การสร้างเสียงแบบ Native

ตั้งค่า generate_audio: true เพื่อให้ Seedance สร้างแทร็กเสียงพร้อมกับวิดีโอ โมเดลจะทำการสร้างเสียงและวิดีโอร่วมกัน ดังนั้นเสียงจะเข้ากับการกระทำบนหน้าจอ แทนที่จะถูกเพิ่มเข้ามาทีหลัง

การสร้างเสียงครอบคลุมบทสนทนา, เอฟเฟกต์เสียง, เสียงบรรยากาศ และเพลงประกอบ การซิงค์ริมฝีปากทำงานได้ในกว่า 8 ภาษา

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A street musician plays guitar outside a cafe in Paris, crowds passing by, city sounds"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=10,
    generate_audio=True,
    watermark=False,
)

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

การควบคุมความละเอียด, อัตราส่วนภาพ และระยะเวลา

สามพารามิเตอร์ที่กำหนดรูปแบบเอาต์พุต:

resolution รองรับ "480p", "720p", "1080p", หรือ "2K" ค่าเริ่มต้นคือ "1080p" ความละเอียดที่สูงขึ้นหมายถึงการใช้โทเค็นมากขึ้นและมีค่าใช้จ่ายสูงขึ้น

ratio รองรับ "16:9", "9:16", "4:3", "3:4", "21:9", "1:1", หรือ "adaptive" ใช้ "adaptive" เมื่อภาพอินพุตของคุณมีอัตราส่วนภาพที่ไม่ปกติ โมเดลจะอ่านขนาดภาพและตั้งค่าอัตราส่วนภาพตามนั้น

duration รองรับจำนวนเต็มตั้งแต่ 4 ถึง 15 หน่วยเป็นวินาที ค่าเริ่มต้นคือ 5 วิดีโอที่ยาวขึ้นจะมีค่าใช้จ่ายเพิ่มขึ้นตามสัดส่วน

โมเดลแบบเร็ว (doubao-seedance-2-0-fast-260128) สร้างวิดีโอคุณภาพต่ำกว่าแต่เสร็จเร็วกว่า ใช้สำหรับสร้างต้นแบบหรือเมื่อคุณกำลังปรับปรุงข้อความสั่ง (prompts) เปลี่ยนไปใช้โมเดลมาตรฐานสำหรับเอาต์พุตระดับโปรดักชัน

เมื่อใดควรเลือก Seedance 2.0 เหนือ API วิดีโออื่นๆ: เลือก Seedance เมื่อคุณต้องการการสร้างเสียง-วิดีโอร่วมกันแบบ native, การควบคุมเฟรมเริ่มต้นและสิ้นสุด หรืออินพุตอ้างอิงแบบหลากหลายสื่อ หากคุณต้องการเพียงแค่ Text-to-video แบบง่ายๆ และให้ความสำคัญกับค่าใช้จ่าย โมเดลแบบเร็วที่ 480p เป็นตัวเลือกที่ถูกที่สุดในคลาสนี้

การอ่านค่าใช้จ่ายจาก Response

หลังจากงานสำเร็จ การตอบกลับจะรวมฟิลด์ usage:

{
  "usage": {
    "completion_tokens": 246840,
    "total_tokens": 246840
  }
}

การใช้โทเค็นมีความสัมพันธ์กับความยาวของวิดีโอและความละเอียด จุดอ้างอิงจากเอกสารทางการ: วิดีโอ 1080p ความยาว 15 วินาทีใช้โทเค็นประมาณ 308,880 โทเค็น วิดีโอ 1080p ความยาว 5 วินาทีใช้โทเค็นประมาณ 102,960 โทเค็น

ราคาสำหรับ T2V และ I2V ที่ 1080p คือ 46 หยวนต่อล้านโทเค็น (ประมาณ $6.40 ต่อล้านโทเค็นตามอัตราแลกเปลี่ยนปัจจุบัน)

ประมาณการคร่าวๆ:

วิดีโอ 1080p 5 วินาที: ประมาณ 102,960 โทเค็น = ประมาณ 0.47 หยวน = ประมาณ $0.93
วิดีโอ 1080p 10 วินาที: ประมาณ 205,920 โทเค็น = ประมาณ 9.47 หยวน = ประมาณ $1.97

สำหรับงาน V2V (คำขอที่มีการอ้างอิงวิดีโอ) อัตราจะลดลงเหลือ 28 หยวนต่อล้านโทเค็น (ประมาณ $3.90 ต่อล้านโทเค็น)

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

สำคัญ: ดาวน์โหลดวิดีโอภายใน 24 ชั่วโมง

video_url ในการตอบกลับที่สำเร็จจะชี้ไปยัง Volcengine object storage URL นั้นจะหมดอายุ 24 ชั่วโมงหลังจากงานสำเร็จ หลังจากนั้น URL จะคืนค่าข้อผิดพลาด 403 และไฟล์จะหายไป

ควรดาวน์โหลดไฟล์ไปยังพื้นที่เก็บข้อมูลของคุณเองทันทีหลังจากสถานะเปลี่ยนเป็น succeeded ลูปการตรวจสอบสถานะในส่วนก่อนหน้าได้รวมขั้นตอนการดาวน์โหลดนี้เป็นส่วนหนึ่งของกระบวนการมาตรฐาน

ฟิลด์ execution_expires_after ยืนยันกรอบเวลาการหมดอายุเป็นวินาที 172800 หมายถึง 48 ชั่วโมงสำหรับบันทึกงานนั้นๆ แต่ URL วิดีโอจะหมดอายุที่ 24 ชั่วโมงไม่ว่าจะอย่างไรก็ตาม ให้เชื่อตามกฎ 24 ชั่วโมง

ประวัติงานยังจำกัดอยู่ที่ 7 วันล่าสุด คุณไม่สามารถสอบถามงานที่เก่ากว่านั้นได้

วิธีทดสอบ Seedance API ด้วย Apidog

รูปแบบงานแบบ asynchronous มีการเรียกใช้ API สองครั้งที่ขึ้นอยู่ซึ่งกันและกัน คุณไม่สามารถเขียนการทดสอบแบบคำขอเดียวได้ Test Scenarios ของ Apidog จัดการสิ่งนี้ด้วยขั้นตอนที่เชื่อมโยงกัน

นี่คือการตั้งค่าที่แน่นอน:

ขั้นตอนที่ 1: สร้าง Test Scenario

ใน Apidog ให้ไปที่โมดูล Tests และสร้าง scenario ใหม่ชื่อ "Seedance 2.0 video generation" ตั้งค่าตัวแปรสภาพแวดล้อม ARK_API_KEY ของคุณในการตั้งค่าสภาพแวดล้อมของ Apidog ใช้ {{ARK_API_KEY}} ในที่ที่คุณต้องการอ้างอิงคีย์

ขั้นตอนที่ 2: เพิ่มคำขอ submit

เพิ่มขั้นตอนคำขอ POST ที่กำหนดเองไปยัง https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks ตั้งค่าส่วนหัว Authorization เป็น Bearer {{ARK_API_KEY}} เพิ่ม JSON body ของคุณพร้อมฟิลด์ model และ content

หลังจากขั้นตอนนี้ ให้เพิ่มโปรเซสเซอร์ Extract Variable ตั้งค่าให้ดึงข้อมูลจาก response body โดยใช้ JSONPath expression $.id บันทึกค่าลงในตัวแปรสภาพแวดล้อมชื่อ TASK_ID

ขั้นตอนที่ 3: เพิ่มโปรเซสเซอร์ Wait

แทรกโปรเซสเซอร์ Wait หลังจากขั้นตอนการดึงข้อมูล ตั้งค่าการหน่วงเวลาเป็น 30 วินาที เพื่อให้โมเดลมีเวลาเริ่มประมวลผลก่อนที่คุณจะพยายามตรวจสอบสถานะครั้งแรก

ขั้นตอนที่ 4: เพิ่มคำขอ poll ใน For loop

เพิ่มบล็อกควบคุม For loop โดยมีจำนวนการวนซ้ำสูงสุด 20 ครั้ง ภายในลูป:

เพิ่มขั้นตอนคำขอ GET ไปยัง https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{{TASK_ID}} ด้วยส่วนหัว Authorization เดียวกัน
เพิ่มโปรเซสเซอร์ Wait โดยมีการหน่วงเวลา 10 วินาทีหลังจากคำขอ GET
ตั้งค่าเงื่อนไข Break If ของลูป: $.status == "succeeded" หรือ $.status == "failed"

ขั้นตอนที่ 5: เพิ่ม assertion

หลังจากลูปสิ้นสุด ให้เพิ่มโปรเซสเซอร์ Assertion ที่ตรวจสอบว่า:

$.status เท่ากับ "succeeded"
$.content.video_url ไม่ว่างเปล่า

เรียกใช้ scenario และ Apidog จะสร้างรายงานการทดสอบฉบับเต็มที่แสดงแต่ละขั้นตอน, task ID ที่ดึงมา, การตอบกลับการตรวจสอบสถานะทั้งหมด และว่า assertion สุดท้ายผ่านหรือไม่

คุณยังสามารถนำเข้าปลายทาง Seedance โดยตรงจากคำสั่ง cURL เข้าสู่ขั้นตอน scenario การทดสอบได้ วิธีนี้ใช้ได้ดีเมื่อคุณต้องการเพิ่มคำขอ submit และ poll อย่างรวดเร็วโดยไม่ต้องป้อนส่วนหัวและพารามิเตอร์ทุกรายการด้วยตนเอง

รายละเอียดราคา: วิดีโอ 10 วินาทีมีค่าใช้จ่ายเท่าไหร่

Seedance API ใช้การกำหนดราคาโทเค็นแบบจ่ายตามการใช้งานจริง ไม่มีค่าสมาชิกรายเดือนหรือเครดิตที่ต้องจัดการนอกเหนือจากยอดทดลองใช้เริ่มต้น

ประเภทงาน	อัตรา (ต่อ 1 ล้านโทเค็น)
T2V / I2V ที่ 1080p	46 หยวน (~$6.40)
V2V (อินพุตอ้างอิงวิดีโอ)	28 หยวน (~$3.90)

ค่าใช้จ่ายโดยประมาณสำหรับระยะเวลาทั่วไปที่ 1080p:

ระยะเวลา	โทเค็นโดยประมาณ	ค่าใช้จ่าย (T2V/I2V)
5 วินาที	~103,000	~$0.66 หยวน / ~$0.93
10 วินาที	~206,000	~$9.48 หยวน / ~$1.32
15 วินาที	~309,000	~$14.21 หยวน / ~$1.97

บัญชีใหม่เริ่มต้นด้วยเครดิตทดลองใช้ฟรีที่ครอบคลุมการสร้างวิดีโอ 15 วินาทีแบบเต็มประมาณ 8 ครั้ง ใช้สิทธิ์นี้เพื่อทดลองใช้ prompt และการตั้งค่าก่อนที่จะนำไปใช้งานจริง

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

ข้อผิดพลาดทั่วไปและการแก้ไข

429 Too Many Requests

นี่หมายความว่าคุณชนขีดจำกัดการทำงานพร้อมกัน (concurrency limit) ไม่ใช่ขีดจำกัดอัตรา (rate limit) ของคำขอต่อนาที มีงานทำงานพร้อมกันมากเกินไป ใช้ exponential backoff เมื่อคุณเห็นรหัสสถานะนี้ เริ่มต้นด้วยการรอ 10 วินาทีและเพิ่มเป็นสองเท่าในการลองใหม่แต่ละครั้ง โดยจำกัดสูงสุดที่ 60 วินาที ลูปการตรวจสอบสถานะที่แสดงไว้ก่อนหน้านี้รวมรูปแบบนี้ไว้ด้วย

status: "failed"

งานที่ล้มเหลวหมายความว่าโมเดลไม่สามารถสร้างวิดีโอได้ สาเหตุทั่วไป: ข้อความสั่ง (prompt) มีเนื้อหาที่ละเมิดตัวกรองความปลอดภัย, ภาพอินพุตเสียหายหรือมีขนาดใหญ่เกินไป หรือการรวมกันของพารามิเตอร์ไม่ถูกต้อง ตรวจสอบไฟล์อินพุตและข้อความสั่งของคุณ จากนั้นส่งใหม่

status: "expired"

งานจะหมดอายุหากอยู่ในคิวนานเกินไปโดยไม่เสร็จสิ้น สิ่งนี้สามารถเกิดขึ้นได้ในช่วงเวลาที่มีโหลดสูงสุด ให้ส่งงานใหม่ ไม่มีวิธีที่จะเริ่มงานที่หมดอายุแล้วได้

403 on video_url

URL หมดอายุแล้ว ช่วงเวลา 24 ชั่วโมงผ่านไปก่อนที่คุณจะดาวน์โหลดไฟล์ บันทึกงานอาจยังคงอยู่ใน API ได้สูงสุด 7 วัน แต่ไฟล์วิดีโอหายไปแล้ว คุณจะต้องสร้างใหม่โดยใช้พารามิเตอร์เดียวกันและค่า seed หากคุณบันทึกไว้

Seed reproducibility

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

บทสรุป

Seedance 2.0 API มอบการเข้าถึงแบบโปรแกรมไปยังหนึ่งในโมเดลการสร้างวิดีโอที่ทรงประสิทธิภาพที่สุดที่มีอยู่ในปัจจุบัน รูปแบบงานแบบ asynchronous นั้นเข้าใจง่าย: POST เพื่อสร้างงาน, ตรวจสอบสถานะจนกว่าจะสำเร็จ, ดาวน์โหลดทันที อินพุตแบบหลากหลายสื่อ, การสร้างเสียงแบบ native และการควบคุมเฟรมเริ่มต้นและสิ้นสุด ทำให้สามารถสร้างเวิร์กโฟลว์วิดีโอที่ไม่สามารถทำได้จากเว็บคอนโซล

ตั้งค่าการครอบคลุมการทดสอบของคุณใน Apidog ก่อนที่คุณจะนำไปใช้งานจริง ชุด Test Scenario จะตรวจจับตรรกะการตรวจสอบสถานะที่ผิดพลาด, ขั้นตอนการดึงข้อมูลที่หายไป และปัญหาการหมดอายุของ URL ก่อนที่จะส่งผลกระทบต่อผู้ใช้จริง

ปุ่ม

คำถามที่พบบ่อย

ถาม: อะไรคือความแตกต่างระหว่าง doubao-seedance-2-0-260128 และ doubao-seedance-2-0-fast-260128?

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

ถาม: ฉันสามารถใช้ Seedance 2.0 นอกประเทศจีนได้หรือไม่?

ปลายทาง API โฮสต์อยู่ในภูมิภาคปักกิ่ง นักพัฒนาภายนอกประเทศจีนสามารถเรียกใช้ได้ แต่ความหน่วงจะสูงกว่า ตรวจสอบข้อกำหนดในการให้บริการของ Volcengine สำหรับข้อจำกัดทางภูมิศาสตร์สำหรับประเภทบัญชีของคุณ

ถาม: ฉันจะเชื่อมโยงหลายคลิปเข้าด้วยกันให้เป็นวิดีโอที่ยาวขึ้นได้อย่างไร?

ตั้งค่า return_last_frame: true ในการสร้างแต่ละครั้ง การตอบกลับจะรวมภาพของเฟรมสุดท้ายพร้อมกับ URL ของวิดีโอ ส่งภาพนั้นเป็นเฟรมแรกของคำขอถัดไป ทำซ้ำจนกว่าคุณจะมีคลิปทั้งหมดที่ต้องการ จากนั้นจึงนำมารวมกันโดยใช้ไลบรารีการตัดต่อวิดีโอ

ถาม: การสร้างเสียงแบบ native มีค่าใช้จ่ายสูงขึ้นหรือไม่?

การสร้างเสียงแบบ native เพิ่มการใช้โทเค็นเล็กน้อยเนื่องจากโมเดลทำการสร้างเสียงและวิดีโอร่วมกัน แทนที่จะเป็นเฉพาะวิดีโอเท่านั้น คาดว่าจะมีการเพิ่มขึ้นเล็กน้อยใน completion_tokens เมื่อเทียบกับคำขอเดียวกันที่ไม่มี generate_audio: true

ถาม: ฉันสามารถตั้งค่า webhook แทนการตรวจสอบสถานะได้หรือไม่?

ได้ คุณสามารถส่งพารามิเตอร์ callback_url ในคำขอ submit ของคุณ API จะทำการ POST ผลลัพธ์ของงานที่เสร็จสมบูรณ์ไปยัง URL นั้นเมื่อสถานะเปลี่ยนแปลง วิธีนี้มีประสิทธิภาพมากกว่าการตรวจสอบสถานะสำหรับไปป์ไลน์ที่มีปริมาณงานสูง

ถาม: เกิดอะไรขึ้นหากฉันใช้เกินขีดจำกัด 9 รูปภาพ?

API จะคืนค่าข้อผิดพลาดการตรวจสอบความถูกต้อง 400 ก่อนที่จะสร้างงาน ลดจำนวนรูปภาพในอาร์เรย์ content ของคุณให้เป็น 9 หรือน้อยกว่า

ถาม: พารามิเตอร์ seed รับประกันว่าจะสร้างวิดีโอเดิมซ้ำได้หรือไม่?

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

ถาม: ฉันจะติดตามการใช้จ่ายในหลายๆ งานได้อย่างไร?

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