Seedance 2.0 API

API-ul vă permite să trimiteți sarcini de generare video Seedance 2.0 în mod programatic. Generarea este asincronă: creați o sarcină, primiți un ID de sarcină imediat, apoi obțineți videoclipul finalizat prin interogarea endpoint-ului sarcinii sau prin primirea unui webhook.

Creează o cheie API în tabloul de bord și trimite-o ca token Bearer la fiecare cerere. Cheia completă este afișată o singură dată la momentul creării.

Authorization: Bearer sk_live_xxxxxxxx

Trimiteți o sarcină mai întâi. După ce sarcina este acceptată, alegeți o metodă de livrare a rezultatului: interogați endpoint-ul sarcinii sau primiți rezultatul final printr-un 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 });
}

Creați o sarcină video cu POST /v1/videos/generations. Corpul cererii are un model de nivel superior, un callback_url opțional și un obiect de intrare care conține setări de prompt și de generare.

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 controlează ce intrări media sunt acceptate și cum le interpretează modelul.

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"
    }
  }'

Numele parametrilor, valorile enumerate, căile endpoint-urilor și exemplele fac parte din contractul API. Descrierile de mai jos explică cum se comportă fiecare câmp.

Acesta este răspunsul de succes de la POST /v1/videos/generations. Înseamnă că sarcina a fost acceptată și creditele au fost rezervate. Utilizați taskId returnat pentru a interoga GET /v1/tasks/:id sau pentru a se potrivi cu un callback de finalizare sau eșec.

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

Utilizați GET /v1/tasks/:id pentru a prelua starea curentă a sarcinii. Nu interogați mai des de o dată la 10 secunde. Pentru sistemele de producție, preferați webhook-urile.

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"
}

Când callback_url este prezent, Seedance vă apelează endpoint-ul atunci când sarcina este finalizată sau a eșuat și trimite date JSON care descriu rezultatul final. Dacă endpoint-ul dvs. returnează un răspuns non-2xx sau nu răspunde în 15 secunde, livrarea este reîncercată de până la 5 ori. Reîncercările reutilizează același ID de sarcină, deci deduplicați după ID. Returnați un răspuns 200 imediat ce ați înregistrat în siguranță datele 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 și GET /v1/tasks/:id returnează această formă de eroare atunci când cererea API în sine eșuează, cum ar fi parametri invalizi, cheie API invalidă, credite insuficiente, limitare a ratei sau sarcină negăsită. Unele erori includ câmpuri suplimentare, cum ar fi required, available sau retry_after, în funcție de situație.

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

Limitele de rată sunt aplicate per cheie API cu o fereastră glisantă. Generarea este limitată la 60 de cereri pe minut; interogările de stare sunt mai îngăduitoare. Răspunsurile HTTP 429 includ Retry-After.

API-ul utilizează rezervare la trimitere, taxare la succes și rambursare la eșec. Paginile de utilizare din tabloul de bord afișează istoricul creditelor API, jurnalele de sarcini și statisticile de utilizare bazate pe timp.