Hopp til innholdet
UlazAI

UlazAI utviklerdokumenter

Seedance API dokumentasjon: generering, status, 1080p og priser

Prissetting Dashbord Bildestudio

Seedance 1.5 Pro-referanse

Seedance API dokumenter

For å bruke Seedance API, autentiser med en bærernøkkel, bruk POST /seedance/generate/ å skape arbeidsplasser, og meningsmåling GET /seedance/status/{generation_id}/ til videoen er klar. UlazAI støtter for øyeblikket Seedance 1.5 Pro-utgang i 480p, 720p og 1080p med 4, 8 eller 12 sekunders varighet.

Kjerneendepunkter

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Nåværende evner

Tekst-til-video og bilde-til-video

Opptil 2 guidebilder

Valgfri innfødt lyd

Neste ruter

Kjøp kreditter

Se Seedance-landing

Åpne kanonisk video API-dokumenter

Tips

Denne siden svarer på hele utviklerflyten på det første skjermbildet: generere endepunkt, statuspolling, 1080p-støtte, bærerautentisering og prisruten.

Bruk /seedance/upload/ bare når du trenger bildeveiledet videogenerering. Ring for kun tekstkjøring /seedance/generate/ direkte og hoppe over opplastingstrinnet.

Seedance-modellfamilien: 1.5 Pro, 2.0 og 2.5

Seedance er ByteDance sin tekst-til-video og bilde-til-video-modell. ByteDance lanserte den første Seedance i juni 2025, utgitt Seedance 2.0 i februar 2026, og har siden vist Seedance 2.5. Hver generasjon driver den samme kjerneideen videre: filmisk bevegelse, sterkere prompt-følgende, multi-shot scener, bilde- og videoreferanser, og valgfri innfødt lyd i én enkelt gjengivelse. API-veiledningen dekker det som støttes for øyeblikket Seedance-versjoner uten at du må sette opp ByteDance sin egen plattform.

VersjonUtgitt av ByteDanceHva det tilfører
Seedance 1.5 Pro2025Tekst- og bilde-til-video, opptil 2 guidebilder, valgfri lyd, 480p/720p/1080p. Koblet til UlazAI i dag.
Seedance 2.0februar 2026Multimodale innganger (tekst, bilde, video, lyd), historiefortelling med flere kameraer, samgenerering av naturlig lyd, lengre klipp.
Seedance 2.52026Det nyeste trinnet ByteDance har vist, rettet mot raskere generering og ytterligere kvalitets- og kontrollgevinster.

Samme kode, nyere modell

UlazAIs offentlige API genererer med bytedance/seedance-1.5-pro i dag. Den viktige delen for utviklere: når en nyere Seedance-versjon er aktivert her, gjenbruker den samme Bærer auth og den samme generer-og-spør-endepunkter nedenfor. Integreringen din endres ikke - bare modellidentifikatoren gjør det - så du kan bygge mot denne referansen nå og flytte opp i familien senere.

ByteDance og ARK: den offisielle modellen, én enhetlig rute

Folk som søker etter ByteDance Seedance offisielle dokumentasjon eller den Ark Seedance API er vanligvis ute etter to forskjellige ting: selve modellen, og en måte å faktisk kalle den. Seedance er ByteDance sin egen modell, publisert gjennom ByteDances Volcano Engine ARK plattform. Den ruten betyr å sette opp en ARK konto, regiontilgang og råmodellendepunkter.

UlazAI sitter foran det som et tredjeparts API-lag. Du får en bærenøkkel, en vert bilde opplasting trinn, en delt kredittlommebok og det lille settet med endepunkter på denne siden — ingen ARK onboarding, ingen regional løsning og ingen VPN eller kinesisk telefonnummer for å nå modellen. Hvis du spesifikt søkte ARK API Seedance bildeopplasting, tilsvarende her er et enkelt anrop: POST /seedance/upload/ returnerer en permanent URL som du går inn på input_urls på generere (se opplastingsendepunktet nedenfor).

ARK-konsepter kartlagt til denne API

Hvis du allerede har lest ByteDances ARK-dokumentasjon, er vokabularet annerledes, men det trinnene er de samme. Dette er den direkte oversettelsen:

På ByteDance ARK Her Hva endres for deg
ARK konto, prosjekt og endepunktoppsett En bærenøkkel Ingen plattform onboarding før den første samtalen.
Vert guidebildet selv, send en offentlig URL POST /seedance/upload/ Du kan sende råfilen; svaret gir deg en permanent URL.
Modell-ID i forespørselsteksten model felt Samme idé; bare identifikatoren endres mellom versjoner.
Poll oppgaven til den er fullført GET /seedance/status/{generation_id}/ Samme avstemningsform, ett endepunkt.

Bilde-til-video i to samtaler

Dette er hele bildeopplastingsflyten. Det første anropet lagrer bildet og returnerer en URL, det andre anropet bruker den nettadressen som visuell veiledning for videoen.

Ett opplastet stillbilde til venstre mater en sekvens av genererte videorammer til høyre 
# 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"
      }'

Du kan sende opptil to nettadresser inn input_urls. To bilder leses som en start og sluttreferanse, som er den vanlige måten å holde en karakter eller et produkt konsistent på tvers av klippet. For kun tekstgenerering, hopp over opplastingsanropet helt.

Rask integrasjonsoppsummering

Auth Bærer API nøkkel fra /dashboard/ -> API-nøkler
Modell-ID bytedance/seedance-1.5-pro
Varigheter 4s, 8s, 12s
Vedtak 480p, 720p, 1080p
Sideforhold 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Innganger Bare forespørsel, eller forespørsel pluss opptil 2 bildenettadresser
Avstemningsflyt Skap en jobb, lagre generation_id, deretter avstemningsstatus til completed

Offentlig endepunktsammendrag

Metode Endepunkt Når du skal bruke den
POST /seedance/upload/ Last opp et bilde først hvis du vil ha bilde-til-video-veiledning
POST /seedance/generate/ Lag en Seedance 1.5 Pro generasjonsjobb
FÅ /seedance/status/{generation_id}/ Sjekk om jobben fortsatt behandles, fullført eller mislyktes

Autentisering

Alle API-forespørsler krever et bærertoken:

Authorization: Bearer YOUR_API_KEY

Få en API-nøkkel fra dashbordet under API nøkler. Hvis du fortsatt trenger kreditter, gå til pakker først.

POST /seedance/upload/

Last opp inngangsbilder for bilde-til-video-veiledning

Last opp et guidebilde før generering hvis du vil at Seedance skal forankre komposisjon, karakterinnramming eller sceneoppsett. Svaret gir deg en permanent URL å gå inn på input_urls.

Forespørselshoder

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

Skjemadataparametere

fil * (fil)

JPG, PNG eller WebP, opptil 10 MB.

Suksessrespons (200)

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

Eksempelbruk (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/

Lag en Seedance 1.5 Pro generasjonsoppgave

Send enten den forenklede nyttelasten nedenfor eller den eksplisitte model pluss input format. Bruk den forenklede versjonen hvis du bare trenger den offentlige Seedance-ruten med spørsmål, valgfrie guidebilder og utdatainnstillinger.

Forespørselstekst (enkel)

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

Forespørselstekst (modell/inndatastil)

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

Parametere

prompt * (streng)

3 til 2500 tegn som beskriver scenen, bevegelsen, innrammingen og lydhensikten.

input_urls (matrise)

Valgfritt. Opptil 2 bilde-URLer for bilde-til-video-veiledning.

aspect_ratio (streng)

En av: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.

oppløsning (streng)

En av: 480p, 720p, 1080p.

varighet (streng)

4, 8 eller 12 sekunder.

fixed_lens (boolsk)

Aktiver for en mer stabil kameravisning.

generate_audio (boolsk)

Aktiver synkronisert lydgenerering. Dette øker kredittbruken.

prompt_directory_optin (boolsk)

Valgfritt. Del kvalifiserte forespørsler til promptkatalogen og bruk en rabatt når det støttes.

Suksessrespons (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."
}
FÅ /seedance/status/{generation_id}/

Status for avstemningsoppgave

Spør dette endepunktet til jobben forlater processing. Ved suksess får du en video-URL tilbake; på fiasko du bør inspisere feilen og prøve på nytt med en korrigert nyttelast.

Behandler svar

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

Suksessrespons (200)

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

Kodeeksempler: cURL, Python og JavaScript

Full flyt er send inn → lagre generation_id → avstemningsstatus. Her er genereringskallet i tre vanlige stabler; bytt inn din egen nøkkel og spør.

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 (forespørsler)

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 (hent)

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

Bruksflyt

  1. Last opp ett eller to guidebilder med /seedance/upload/ bare hvis du trenger bilde-til-video-veiledning.
  2. Ring /seedance/generate/ med spørsmål, utdatainnstillinger og valgfritt input_urls.
  3. Oppbevar det returnerte generation_id.
  4. Avstemning /seedance/status/{generation_id}/ inntil status blir completed.
  5. Bruk den returnerte video_url for å laste ned, bygge inn eller overføre den endelige ressursen til din egen arbeidsflyt.

Feilkoder

400 Ugyldige forespørselsparametere

401 Autentisering mislyktes (manglende eller ugyldig API-nøkkel)

402 Utilstrekkelig kreditter

429 Satsgrensen er overskredet

500 Intern serverfeil

Priser og takstgrenser

Seedance-fakturering på UlazAI kjører på kreditter, så kostnadsskalaer med oppløsning og varighet i stedet for en fast sats per sekund. Bruk dette som en planleggingsguide; live kredittkostnaden vises i pakker og på forespørselstidspunkt.

UtgangTypisk brukKostnadsdriver
480pUtkast og raske iterasjonerLaveste kreditter per sekund
720pSosialklare klippMidtpoeng per sekund
1080pEndelig leveringHøyeste kreditter per sekund; lengre varighet koster mer

Satsgrenser og 429-håndtering: hvis du sender inn mange jobber parallelt kan du få 429 Rate limit exceeded. Behandle API som jobbbasert: send inn, lagre generation_id, og avstemning /seedance/status/{generation_id}/ hvert 5.-10. sekund i stedet for å hamre generere. På en 429, slå av eksponentielt (for eksempel 2s, 4s, 8s) før du prøver på nytt.

Seedance 1.5 pro vs Seedance 2.0: denne referansen dekker bytedance/seedance-1.5-pro, modellen som for øyeblikket er koblet til Video Studio. ByteDance har siden introdusert Seedance 2.0 som neste generasjon; når den er aktivert her, bruker den den samme genererings- og avstemningsflyten og samme autentisering, så integrasjonskoden endres ikke - bare modellidentifikatoren gjør det.

Ofte stilte spørsmål

Støtter UlazAI Seedance API Seedance 2.0 og 2.5?

API genererer med bytedance/seedance-1.5-pro i dag. ByteDance ga ut Seedance 2.0 i februar 2026 og har siden vist 2.5. Når en nyere versjon er aktivert her, bruker den samme Bearer-autentisering og de samme genererings- og avstemningsendepunktene, så integrasjonskoden din endres ikke - bare modellidentifikatoren gjør det.

Hvordan forholder UlazAI seg til ByteDances offisielle Seedance / ARK API?

Seedance er ByteDance sin egen modell, som tilbys gjennom ByteDance sin Volcano Engine ARK-plattform. UlazAI er et tredjeparts API-lag som kjører Seedance bak én forenklet rute med en enkelt bærernøkkel, vertsbasert bildeopplasting og en delt kredittlommebok – ingen ARK-konto eller råmodellendepunkter å administrere.

Hvordan laster jeg opp et bilde for Seedance bilde-til-video?

Send bildet som flerdelt/skjemadata til POST /seedance/upload/ med din bærernøkkel. Svaret returnerer en permanent URL; gi den (opptil to) i input_urls array på POST /seedance/generate/. Bare tekstmeldinger hopper over opplastingstrinnet.

Hvor mye koster Seedance API?

Fakturering går på kreditter, så kostnadsskalaer med oppløsning og varighet. Et kort 480p-utkast koster færrest kreditter; en 12-sekunders 1080p gjengivelse med lyd koster mest. Den nøyaktige kostnaden viser seg pakker og igjen som credits_used i genereringssvaret.

Er Seedance tilgjengelig over hele verden gjennom API?

Ja. Du ringer UlazAIs vertsbaserte HTTPS-endepunkter med en bærernøkkel, så ingen VPN, regional løsning eller kinesisk telefonnummer er nødvendig. Enhver server som kan foreta en autentisert HTTPS-forespørsel kan sende inn jobber og spørre etter resultater.

Hvor du skal gå videre

Kjøp kreditter Seedance 1.5 pro landing Seedance 2-priser Video API dokumenter API referanseindeks Åpne Seedance i Video Studio