Seedance 2.0 API

API ช่วยให้คุณส่งงานสร้างวิดีโอ Seedance 2.0 แบบโปรแกรม การสร้างเป็นแบบอะซิงโครนัส: สร้างงาน, รับ ID งานทันที, จากนั้นรับวิดีโอที่เสร็จสมบูรณ์โดยการสำรวจสถานะที่เอ็นด์พอยต์ของงาน หรือโดยการรับเว็บฮุค

สร้างคีย์ API ในแดชบอร์ดและส่งเป็น Bearer token ในทุกคำขอ คีย์ทั้งหมดจะแสดงเพียงครั้งเดียวเมื่อสร้าง

Authorization: Bearer sk_live_xxxxxxxx

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

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

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

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

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

สร้างงานวิดีโอด้วย POST /v1/videos/generations เนื้อหาคำขอมีโมเดลระดับบนสุด, callback_url (ไม่บังคับ) และออบเจกต์อินพุตที่มี prompt และการตั้งค่าการสร้าง

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

generation_type ควบคุมว่าสื่ออินพุตใดที่ได้รับการยอมรับ และโมเดลตีความอย่างไร

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cinematic drone shot over a futuristic coastal city at sunrise",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "the subject turns toward camera, soft studio motion",
      "generation_type": "image-to-video",
      "image_urls": ["https://your.cdn.com/first-frame.jpg"],
      "duration": 5,
      "resolution": "720p"
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "use the product from image 1 and the camera motion from the reference video",
      "generation_type": "reference-to-video",
      "image_urls": ["https://your.cdn.com/product.jpg"],
      "video_urls": ["https://your.cdn.com/camera-motion.mp4"],
      "audio_urls": [],
      "duration": 8,
      "resolution": "1080p"
    }
  }'

ชื่อพารามิเตอร์, ค่า enum, พาธเอ็นด์พอยต์ และตัวอย่างเป็นส่วนหนึ่งของสัญญา API คำอธิบายด้านล่างอธิบายพฤติกรรมของแต่ละฟิลด์

นี่คือการตอบสนองที่สำเร็จจาก POST /v1/videos/generations ซึ่งหมายความว่างานได้รับการยอมรับและเครดิตได้รับการสำรองไว้ ใช้ taskId ที่ส่งคืนเพื่อสำรวจ GET /v1/tasks/:id หรือเพื่อจับคู่การแจ้งเตือนการเสร็จสมบูรณ์หรือความล้มเหลว

{
  "taskId": "3f2aK9mR...",
  "credits": 60
}

ใช้ GET /v1/tasks/:id เพื่อเรียกคืนสถานะงานปัจจุบัน สำรวจสถานะไม่เกิน 1 ครั้งทุก 10 วินาที สำหรับระบบการผลิต ควรใช้เว็บฮุค

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "charged",
  "credits": 60,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "refunded",
  "credits": 60,
  "failed_reason": "provider_failed"
}

เมื่อมี callback_url, Seedance จะเรียกเอ็นด์พอยต์ของคุณเมื่องานเสร็จสมบูรณ์หรือล้มเหลว และส่งข้อมูล JSON ที่อธิบายผลลัพธ์สุดท้าย หากเอ็นด์พอยต์ของคุณส่งคืนการตอบสนองที่ไม่ใช่ 2xx หรือไม่ตอบสนองภายใน 15 วินาที การส่งจะถูกลองใหม่สูงสุด 5 ครั้ง การลองใหม่จะใช้ id งานเดียวกัน ดังนั้นให้ de-dupe ด้วย id ส่งคืนการตอบสนอง 200 ทันทีที่คุณบันทึกข้อมูล callback ได้อย่างปลอดภัย

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 60
  }
}

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

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

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

POST /v1/videos/generations และ GET /v1/tasks/:id จะส่งคืนรูปแบบข้อผิดพลาดนี้เมื่อคำขอ API เองล้มเหลว เช่น พารามิเตอร์ไม่ถูกต้อง, API key ไม่ถูกต้อง, เครดิตไม่เพียงพอ, เกินขีดจำกัดอัตรา หรือไม่พบงาน ข้อผิดพลาดบางอย่างมีฟิลด์เพิ่มเติม เช่น required, available หรือ retry_after ขึ้นอยู่กับสถานการณ์

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this task.",
    "required": 60,
    "available": 12
  }
}

มีการกำหนดขีดจำกัดอัตราต่อ API key โดยใช้หน้าต่างแบบเลื่อน การสร้างค่าเริ่มต้นคือ 60 คำขอต่อนาที; การสอบถามสถานะมีความยืดหยุ่นมากขึ้น การตอบกลับ HTTP 429 มี Retry-After

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