Sari la conținut
UlazAI

UlazAI documente pentru dezvoltatori

Documentația Seedance API: generare, stare, 1080p și prețuri

Prețuri Bord Studio de imagine

Referință Seedance 1.5 Pro

Seedance API docs

Pentru a utiliza Seedance API, autentificați-vă cu o cheie purtător, utilizați POST /seedance/generate/ pentru a crea locuri de muncă și pentru a vota GET /seedance/status/{generation_id}/ până când videoclipul este gata. UlazAI acceptă în prezent ieșirea Seedance 1.5 Pro în 480p, 720p și 1080p cu durate de 4, 8 sau 12 secunde.

Puncte finale de bază

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Capacitățile actuale

Text-to-video și imagine-to-video

Până la 2 imagini ghid

Audio nativ opțional

Următoarele rute

Cumpărați credite

Vezi Seedance landing

Deschideți documentele video canonice API

Sfat

Această pagină răspunde la fluxul complet al dezvoltatorului din primul ecran: punctul final de generare, sondarea de stare, suport 1080p, auth Bearer și ruta de preț.

Utilizați /seedance/upload/ numai atunci când aveți nevoie de generare video ghidată de imagini. Pentru rulări numai text, sunați /seedance/generate/ direct și săriți pasul de încărcare.

Familia de modele Seedance: 1.5 Pro, 2.0 și 2.5

Seedance este modelul text-to-video și imagine-video al ByteDance. ByteDance a lansat primul Seedance în iunie 2025, eliberat Seedance 2.0 în februarie 2026 și de atunci a arătat Seedance 2.5. Fiecare generație împinge aceeași idee de bază mai departe: mișcare cinematografică, urmărire promptă mai puternică, scene cu mai multe filmări, referințe la imagini și videoclipuri și audio nativ opțional într-o singură randare. Ghidul API acoperă cele acceptate în prezent Versiuni Seedance fără a fi necesar să configurați propria platformă ByteDance.

VersiuneLansat de ByteDanceCe adaugă
Seedance 1.5 Pro2025Text și imagine-video, până la 2 imagini ghid, audio opțional, 480p/720p/1080p. Conectat la UlazAI astăzi.
Seedance 2.0februarie 2026Intrări multimodale (text, imagine, video, audio), povestire cu mai multe camere, cogenerare audio nativă, clipuri mai lungi.
Seedance 2.52026Cel mai nou pas pe care l-a arătat ByteDance, care vizează o generare mai rapidă și câștiguri suplimentare de calitate și control.

Același cod, model mai nou

UlazAI public API generează cu bytedance/seedance-1.5-pro azi. Partea importantă pentru dezvoltatori: atunci când o versiune mai nouă de Seedance este activată aici, acesta reutiliza la fel Autentificarea purtătorului și la fel punctele finale de generare și sondare de mai jos. Integrarea dvs. nu se schimbă - doar identificatorul de model se schimbă - deci puteți construi pe baza acestei referințe acum și puteți muta familia mai târziu.

ByteDance și ARK: modelul oficial, o rută unificată

Oameni care caută Documentația oficială ByteDance Seedance sau cel Ark Seedance API caută de obicei două lucruri diferite: modelul în sine și o modalitate de a-l numi efectiv. Seedance este al lui ByteDance propriul model, publicat prin Volcano Engine de la ByteDance ARK platforma. Această rută înseamnă instalarea unui ARK cont, acces la regiune și puncte finale de model brut.

UlazAI se află în fața acestuia ca strat API terță parte. Primești o cheie purtător, un găzduit încărcarea imaginii pas, un portofel de credit partajat și un set mic de puncte finale de pe această pagină - fără ARK integrare, nicio soluție regională și nici un număr de telefon VPN sau chinezesc pentru a ajunge la model. Dacă ai căutat în mod special Încărcarea imaginii ARK API Seedance, echivalentul aici este un singur apel: POST /seedance/upload/ returnează o adresă URL permanentă pe care o introduceți input_urls la generare (consultați punctul final de încărcare de mai jos).

Concepte ARK mapate la acest API

Dacă ați citit deja documentația ARK a ByteDance, vocabularul este diferit, dar pașii sunt aceiași. Aceasta este traducerea directă:

Pe ByteDance ARK Aici Ce se schimbă pentru tine
Configurare cont ARK, proiect și punct final O cheie purtător Nicio înregistrare a platformei înainte de primul apel.
Găzduiți singur imaginea ghidului, transmiteți o adresă URL publică POST /seedance/upload/ Puteți trimite fișierul brut; răspunsul vă oferă o adresă URL permanentă.
Id-ul modelului în corpul solicitării model câmp Aceeași idee; doar identificatorul se schimbă între versiuni.
Sondați sarcina până când se finalizează GET /seedance/status/{generation_id}/ Aceeași formă de sondare, un punct final.

Imagine-to-video în două apeluri

Acesta este întregul flux de încărcare a imaginii. Primul apel stochează imaginea și returnează o adresă URL, al doilea apel folosește acea adresă URL ca ghid vizual pentru videoclip.

O imagine statică încărcată în stânga, care furnizează o secvență de cadre video generate în partea dreaptă 
# 1. upload the guide image
curl -X POST https://ulazai.com/seedance/upload/ \
  -H "Authorization: Bearer $ULAZAI_API_KEY" \
  -F "[email protected]"

# -> {"url": "https://cdn.ulazai.com/uploads/<id>.jpg"}

# 2. generate, passing that URL back in input_urls
curl -X POST https://ulazai.com/seedance/generate/ \
  -H "Authorization: Bearer $ULAZAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "slow dolly in, warm evening light",
        "input_urls": ["https://cdn.ulazai.com/uploads/<id>.jpg"],
        "resolution": "1080p"
      }'

Puteți trece până la două adrese URL input_urls. Două imagini sunt citite drept început și referință finală, care este modalitatea obișnuită de a menține un caracter sau un produs consistent pe tot clip. Pentru generarea doar text, săriți complet apelul de încărcare.

Rezumat rapid de integrare

Auth Purtător API cheie de la /dashboard/ -> Chei API
ID model bytedance/seedance-1.5-pro
Durate 4s, 8s, 12s
Rezoluții 480p, 720p, 1080p
Raport de aspect 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Intrări Numai Prompt sau prompt plus până la 2 adrese URL pentru imagini
Fluxul sondajelor Creați un loc de muncă, depozitați generation_id, apoi starea sondajului până la completed

Rezumatul punctului final public

Metoda Punct final Când să-l folosești
POSTĂ /seedance/upload/ Încărcați mai întâi o imagine dacă doriți îndrumare imagine-video
POSTĂ /seedance/generate/ Creați un job de generare Seedance 1.5 Pro
GET /seedance/status/{generation_id}/ Verificați dacă lucrarea este încă în procesare, finalizată sau eșuată

Autentificare

Toate cererile API necesită un simbol Bearer:

Authorization: Bearer YOUR_API_KEY

Obțineți o cheie API din tabloul de bord de sub API Chei. Dacă mai aveți nevoie de credite, accesați pachete mai întâi.

POSTĂ /seedance/upload/

Încărcați imagini de intrare pentru ghidare imagine-video

Încărcați o imagine de ghid înainte de generare dacă doriți ca Seedance să ancoreze compoziția, încadrarea personajelor sau configurarea scenei. Răspunsul vă oferă o adresă URL permanentă pe care să o transmiteți input_urls.

Antete de solicitare

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Parametrii datelor din formular

dosar * (dosar)

JPG, PNG sau WebP, până la 10 MB.

Răspuns de succes (200)

{
  "success": true,
  "url": "https://media.ulazai.com/seedance_images/u1_abc123.jpg",
  "filename": "seedance_images/u1_abc123.jpg"
}

Exemplu de utilizare (cURL)

curl -X POST https://api.ulazai.com/seedance/upload/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"
POSTĂ /seedance/generate/

Creați o sarcină de generare Seedance 1.5 Pro

Trimiteți fie sarcina utilă simplificată de mai jos, fie cea explicită model plus input format. Utilizați versiunea simplificată dacă aveți nevoie doar de ruta publică Seedance cu prompt, imagini de ghid opționale și setări de ieșire.

Corpul cererii (simplu)

{
  "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
  "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": "4",
  "fixed_lens": true,
  "generate_audio": false,
  "prompt_directory_optin": true
}

Corpul solicitării (model/stil de intrare)

{
  "model": "bytedance/seedance-1.5-pro",
  "input": {
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "fixed_lens": true,
    "generate_audio": true
  }
}

Parametrii

prompt * (șir)

3 până la 2500 de caractere care descriu scena, mișcarea, încadrarea și intenția audio.

input_urls (matrice)

Opțional. Până la 2 adrese URL de imagine pentru ghidare imagine-video.

aspect_ratio (șir)

Unul dintre: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.

rezoluție (șir)

Unul dintre: 480p, 720p, 1080p.

durată (șir)

4, 8 sau 12 secunde.

fixed_lens (boolean)

Activați pentru o vizualizare mai stabilă a camerei.

generate_audio (boolean)

Activați generarea audio sincronizată. Acest lucru crește utilizarea creditului.

prompt_directory_optin (boolean)

Opțional. Distribuiți prompt eligibile în directorul prompt și aplicați o reducere atunci când este acceptat.

Răspuns de succes (200)

{
  "success": true,
  "generation_id": "abc12345-1234-1234-1234-123456789012",
  "task_id": "seedance_task_xyz789",
  "credits_used": 40,
  "directory_discount_applied": true,
  "message": "Video generation started. This may take a few minutes."
}
GET /seedance/status/{generation_id}/

Starea sarcinii de sondaj

Interogați acest punct final până când locul de muncă pleacă processing. La succes, primiți înapoi o adresă URL a videoclipului; la eșec ar trebui să inspectați eroarea și să încercați din nou cu o sarcină utilă corectată.

Procesarea răspunsului

{
  "success": true,
  "status": "processing",
  "message": "Video is being generated..."
}

Răspuns de succes (200)

{
  "success": true,
  "status": "completed",
  "video_url": "https://media.ulazai.com/seedance_outputs/video.mp4"
}

Exemple de cod: cURL, Python și JavaScript

Fluxul complet este submit → store generation_id → starea sondajului. Iată apelul de generare în trei stive comune; schimbați propria cheie și prompt.

cURL

curl -X POST https://api.ulazai.com/seedance/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "4"
  }'

Python (cereri)

import time, requests

BASE = "https://api.ulazai.com"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# 1. Start the job
job = requests.post(f"{BASE}/seedance/generate/", headers=HEADERS, json={
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "4",
}).json()
generation_id = job["generation_id"]

# 2. Poll until it leaves "processing"
while True:
    status = requests.get(f"{BASE}/seedance/status/{generation_id}/", headers=HEADERS).json()
    if status.get("status") == "completed":
        print("Video:", status["video_url"])
        break
    if status.get("status") == "failed":
        raise RuntimeError(status)
    time.sleep(8)  # back off; do not hammer generate

JavaScript (preluare)

const BASE = "https://api.ulazai.com";
const HEADERS = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const job = await fetch(`${BASE}/seedance/generate/`, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    prompt: "A cinematic close-up of a chef flipping noodles in slow motion",
    aspect_ratio: "16:9",
    resolution: "1080p",
    duration: "4",
  }),
}).then(r => r.json());

const id = job.generation_id;
let video;
while (!video) {
  const s = await fetch(`${BASE}/seedance/status/${id}/`, { headers: HEADERS }).then(r => r.json());
  if (s.status === "completed") video = s.video_url;
  else if (s.status === "failed") throw new Error(JSON.stringify(s));
  else await new Promise(r => setTimeout(r, 8000));  // poll every ~8s
}
console.log("Video:", video);

Fluxul de utilizare

  1. Încărcați una sau două imagini de ghid cu /seedance/upload/ numai dacă aveți nevoie de ghidare imagine-video.
  2. Sună /seedance/generate/ cu promptul dvs., setările de ieșire și opțional input_urls.
  3. Păstrați cele returnate generation_id.
  4. Sondaj /seedance/status/{generation_id}/ până când status devine completed.
  5. Folosiți cele returnate video_url pentru a descărca, încorpora sau trece materialul final în propriul flux de lucru.

Coduri de eroare

400 Parametri de solicitare nevalidi

401 Autentificarea eșuată (cheie API lipsă sau nevalidă)

402 Credite insuficiente

429 Limita ratei a fost depășită

500 Eroare internă de server

Prețuri și limite de tarife

Facturarea Seedance pe UlazAI se desfășoară pe credite, astfel încât costurile cresc cu rezoluție și durată, mai degrabă decât cu o rată fixă pe secundă. Utilizați acest lucru ca ghid de planificare; costul creditului real este afișat în pachete și la momentul solicitării.

IeșireUtilizare tipicăFactorul de costuri
480pSchițe și iterații rapideCele mai mici credite pe secundă
720pClipuri pregătite pentru socializareCredite medii pe secundă
1080pLivrare finalăCele mai mari credite pe secundă; duratele mai lungi costa mai mult

Limitele ratei și manipularea 429: dacă depuneți mai multe joburi în paralel este posibil să primiți 429 Rate limit exceeded. Tratați API ca pe baza de locuri de muncă: trimiteți, stocați generation_id, și sondaj /seedance/status/{generation_id}/ la fiecare 5-10 secunde, mai degrabă decât ciocănirea generează. Pe a 429, retrageți exponențial (de exemplu, 2s, 4s, 8s) înainte de a reîncerca.

Seedance 1.5 pro vs Seedance 2.0: această referință acoperă bytedance/seedance-1.5-pro, modelul conectat în prezent în Video Studio. ByteDance a introdus de atunci Seedance 2.0 ca următoarea generație; când este activat aici, folosește același flux de generare și sondare și aceeași autorizare, astfel încât codul de integrare nu se schimbă - doar identificatorul de model se schimbă.

Întrebări frecvente

UlazAI Seedance API acceptă Seedance 2.0 și 2.5?

API generează cu bytedance/seedance-1.5-pro azi. ByteDance a lansat Seedance 2.0 în februarie 2026 și de atunci a afișat 2.5. Când o versiune mai nouă este activată aici, aceasta folosește aceeași auth Bearer și aceleași puncte finale de generare și sondare, astfel încât codul dvs. de integrare nu se schimbă - doar identificatorul de model se schimbă.

Cum se leagă UlazAI de Seedance oficial al ByteDance / ARK API?

Seedance este propriul model ByteDance, oferit prin platforma Volcano Engine ARK de la ByteDance. UlazAI este un strat API terță parte care rulează Seedance în spatele unei rute simplificate cu o singură cheie Bearer, încărcare de imagini găzduite și un portofel de credit partajat - fără cont ARK sau puncte finale de model brut de gestionat.

Cum încarc o imagine pentru Seedance imagine-to-video?

Trimiteți imaginea ca mai multe părți/form-date către POST /seedance/upload/ cu cheia de la purtător. Răspunsul returnează o adresă URL permanentă; trece-l (până la două) în input_urls matrice activată POST /seedance/generate/. prompt numai text omit pasul de încărcare.

Cât costă Seedance API?

Facturarea se desfășoară pe bază de credite, așa că costurile cresc în funcție de rezoluție și durată. Un scurt draft de 480p costă cele mai puține credite; o randare 1080p de 12 secunde cu audio costă cel mai mult. Costul exact apare în pachete şi iarăşi ca credits_used în răspunsul generat.

Este Seedance disponibil la nivel mondial prin API?

Da. Apelați punctele finale HTTPS găzduite ale lui UlazAI cu o cheie Bearer, astfel încât nu este nevoie de VPN, soluție regională sau număr de telefon chinez. Orice server care poate face o cerere HTTPS autentificată poate trimite joburi și poate sonda rezultate.

Unde să merg mai departe

Cumpărați credite Seedance 1.5 Pro aterizare Prețurile Seedance 2 Documente video API Index de referință API Deschideți Seedance în Video Studio