Seedance 2.0 API

ה-API מאפשר לך להגיש משימות יצירת וידאו Seedance 2.0 באופן פרוגרמטי. היצירה היא אסינכרונית: צור משימה, קבל מזהה משימה באופן מיידי, ואז קבל את הסרטון המוגמר על ידי סקר נקודת קצה המשימה או על ידי קבלת webhook.

צור מפתח API בלוח המחוונים ושלח אותו כאסימון Bearer בכל בקשה. המפתח המלא מוצג רק פעם אחת בזמן היצירה.

Authorization: Bearer sk_live_xxxxxxxx

הגש משימה קודם. לאחר שהמשימה התקבלה, בחר שיטת מסירת תוצאה אחת: סרוק את נקודת קצה המשימה, או קבל את התוצאה הסופית באמצעות webhook.

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 אופציונלי, ואובייקט קלט המכיל הגדרות הנחיה ויצירה.

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 כדי לאחזר את מצב המשימה הנוכחי. אל תבצע סקר יותר מפעם אחת כל 10 שניות. עבור מערכות פרודקשן, העדף webhooks.

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 פעמים. נסיונות חוזרים משתמשים באותו מזהה משימה, אז בטל כפילויות לפי מזהה. החזר תגובת 200 בהקדם האפשרי לאחר שרשמת את נתוני הקריאה החוזרת בבטחה.

{
  "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 לא חוקי, זיכויים לא מספיקים, הגבלת קצב או משימה שלא נמצאה. חלק מהשגיאות כוללות שדות נוספים כגון required, available או retry_after בהתאם למצב.

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

מגבלות קצב מיושמות לכל מפתח API עם חלון הזזה. יצירה מוגדרת כברירת מחדל ל-60 בקשות לדקה; שאילתות סטטוס יותר מקלות. תגובות HTTP 429 כוללות Retry-After.

ה-API משתמש בשמירה בהגשה, חיוב בהצלחה והחזר כספי בכישלון. דפי השימוש בלוח המחוונים מציגים היסטוריית זיכויים של ה-API, יומני משימות וסטטיסטיקות שימוש מבוססות זמן.