API Seedance

API-ul vă permite să trimiteți programatic sarcini de generare video pentru Seedance 2.5 și Seedance 2.0. Seedance 2.5 este modelul recomandat și acceptă text-to-video, image-to-video (folosind prima cadru sau primul și ultimul cadru) și referințe multimodale (reference-to-video). Generarea este asincronă: creați o sarcină, primiți imediat un ID de sarcină, iar apoi obțineți videoclipul finalizat prin interogarea (polling) endpoint-ului de stare sau prin intermediul unui webhook.

Creați o cheie API în panoul de control și trimiteți-o ca token Bearer la fiecare solicitare. Cheia completă este afișată o singură dată, în momentul creării.

Authorization: Bearer sk_live_xxxxxxxx

Mai întâi, trimiteți o sarcină. După ce sarcina este acceptată, alegeți una dintre metodele de livrare a rezultatului: interogați periodic endpoint-ul sarcinii sau primiți rezultatul final prin intermediul unui webhook.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.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 printr-o solicitare POST la /v1/videos/generations. Corpul solicitării conține modelul la nivel superior, un parametru opțional callback_url și un obiect input cu setările pentru prompt și generare.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

Parametrul generation_type controlează ce tipuri de fișiere media sunt acceptate și modul în care modelul le interpretează.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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": "720p"
    }
  }'

Numele parametrilor, valorile de tip enum, căile endpoint-urilor și exemplele fac parte din contractul API. Descrierile de mai jos explică comportamentul fiecărui câmp în detaliu.

Acesta este răspunsul de succes primit la solicitarea POST /v1/videos/generations. Acesta indică faptul că sarcina a fost acceptată și creditele au fost rezervate. Utilizați valoarea taskId returnată pentru a interoga endpoint-ul GET /v1/tasks/:id sau pentru a o asocia cu datele primite prin webhook în caz de succes sau eșec.

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

Utilizați GET /v1/tasks/:id pentru a obține starea curentă a sarcinii. Se recomandă interogarea la intervale de cel puțin 10 secunde. Pentru sistemele de producție, se recomandă utilizarea webhook-urilor.

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

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

Atunci când parametrul callback_url este configurat, Seedance vă va apela endpoint-ul imediat ce sarcina s-a finalizat sau a eșuat, trimițând date în format JSON cu rezultatul final. Dacă endpoint-ul dvs. returnează un cod diferit de 2xx sau nu răspunde în termen de 15 secunde, transmiterea se va reîncerca de până la 5 ori. Reîncercările folosesc același task id, deci asigurați-vă că faceți deduplicarea în funcție de ID. Returnați un răspuns HTTP 200 imediat ce ați înregistrat cu succes datele primite prin webhook.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

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 });
}

Solicitările POST /v1/videos/generations și GET /v1/tasks/:id returnează această structură de eroare atunci când solicitarea API în sine eșuează (de exemplu: parametri nevalizi, cheie API incorectă, credite insuficiente, depășirea limitelor de trafic sau sarcină negăsită). Anumite erori pot conține câmpuri suplimentare precum required, available sau retry_after, în funcție de situație.

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

Limitele de utilizare se aplică per cheie API folosind o fereastră glisantă. Pentru generare, limita implicită este de 100 de solicitări pe minut; interogările de stare au limite mai permisive. Răspunsurile HTTP 429 includ antetul Retry-After.

API-ul funcționează pe principiul: rezervare la trimitere, taxare la finalizarea cu succes și rambursare în caz de eșec. Paginile dedicate din panoul de control afișează istoricul creditelor API, jurnalul de sarcini și statistici de utilizare în timp.