Seedance 2.0
Seedance 2.0
เอกสารเริ่มต้นใช้งาน
ภาพรวม APIข้อความเป็นวิดีโอภาพเป็นวิดีโอ
เอกสารอ้างอิง API

ภาพรวม API

ทำความเข้าใจการยืนยันตัวตน การส่งงาน การตรวจสอบสถานะ และ webhook ของ Seedance 2.0 Open API

Seedance 2.0 Open API ช่วยให้คุณส่งงานสร้างวิดีโอแบบ asynchronous จากผลิตภัณฑ์ของคุณเอง และรับผลลัพธ์เมื่อประมวลผลเสร็จแล้ว

Base URL

https://www.seedance2.ink

Authentication

คำขอ Open API ทั้งหมดใช้ Bearer token ที่สร้างจากแดชบอร์ด Seedance

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

ขั้นตอนการเชื่อมต่อ

  1. สร้าง API Key ในแดชบอร์ด Seedance
  2. ส่งงานด้วย POST /api/open/v1/video/generations
  3. เก็บค่า requestId ที่ระบบส่งกลับมา
  4. ทำ polling ไปที่ GET /api/open/v1/video/generations/{requestId} จนกว่างานจะจบ
  5. หากต้องการ สามารถใช้ webhook เพื่อรับการแจ้งเตือนเมื่องานเสร็จ

Endpoint หลัก

MethodEndpointDescription
GET/api/open/v1/modelsแสดงโมเดล ระยะเวลา อัตราส่วน ความละเอียด และข้อมูลราคา
POST/api/open/v1/video/generationsสร้างงานสร้างวิดีโอใหม่
GET/api/open/v1/video/generations/{requestId}ตรวจสอบสถานะงานและคืนค่า URL ของผลลัพธ์เมื่อพร้อม
POST/api/open/v1/video/generations/{requestId}/cancelยกเลิกงานที่อยู่ในคิวหรือกำลังประมวลผล

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

สถานะ

StatusDescription
queuedระบบรับคำขอแล้วและกำลังรอในคิว
processingระบบกำลังประมวลผลการสร้าง
succeededงานสำเร็จแล้วและมี output.url ให้ใช้งาน
failedงานล้มเหลว โปรดตรวจสอบ error
cancelledงานถูกยกเลิกก่อนเสร็จสิ้น

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

คุณสามารถกำหนด webhookUrl ต่อคำขอ หรือกำหนด callback เริ่มต้นไว้ที่ระดับ API Key

  • หากมีทั้งสองแบบ ระบบจะใช้ webhookUrl จากคำขอก่อน
  • หากตั้งค่า Webhook Secret ระบบจะส่ง header x-seedance-signature มาด้วย
  • Webhook จะถูกส่งเมื่อสถานะของงานเป็นสถานะสุดท้ายเท่านั้น
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

รหัสข้อผิดพลาด

HTTP statusError codeDescription
400invalid_requestข้อมูลคำขอไม่ตรงกับ schema ที่คาดไว้
401unauthorizedAPI Key หายไปหรือไม่ถูกต้อง
402insufficient_creditsเครดิตไม่เพียงพอสำหรับสร้างงาน
404not_foundไม่พบงานภายใต้ API Key ปัจจุบัน
429rate_limitedเกินลิมิตต่อหนึ่งนาทีหรือโควต้ารายเดือน
500internal_errorเกิดข้อผิดพลาดภายในที่ไม่คาดคิด

ขั้นตอนถัดไป

  • อ่าน ข้อความเป็นวิดีโอ
  • อ่าน ภาพเป็นวิดีโอ

เริ่มต้นใช้งาน

วิธีที่เร็วที่สุดในการเริ่มใช้งาน Seedance 2.0 ให้เกิดประสิทธิภาพ

ข้อความเป็นวิดีโอ

สร้างวิดีโอจากพรอมต์ข้อความด้วย Seedance 2.0 Open API

สารบัญ

Base URLAuthenticationขั้นตอนการเชื่อมต่อEndpoint หลักAvailable ModelsสถานะModels Endpoint ExampleWebhookรหัสข้อผิดพลาดขั้นตอนถัดไป