Hoppa till innehållet
UlazAI

UlazAI utvecklardokument

Seedance API dokumentation: generera, status, 1080p och prissättning

Prissättning Instrumentbräda Bildstudio

Seedance 1.5 Pro referens

Seedance API docs

Att använda Seedance API, autentisera med en bärarnyckel, använd POST /seedance/generate/ för att skapa jobb och enkät GET /seedance/status/{generation_id}/ tills videon är klar. UlazAI stöder för närvarande Seedance 1.5 Pro-utgång i 480p, 720p och 1080p med 4, 8 eller 12 sekunders varaktighet.

Kärnslutpunkter

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Nuvarande kapacitet

Text-till-video och bild-till-video

Upp till 2 guidebilder

Valfritt inbyggt ljud

Nästa rutter

Köp krediter

Se Seedance-landning

Öppna kanoniska video API-dokument

Tips

Den här sidan svarar på hela utvecklarflödet på den första skärmen: generera slutpunkt, statuspolling, 1080p-stöd, bärarautentisering och prissättningsrutten.

Använd /seedance/upload/ endast när du behöver bildstyrd videogenerering. Ring för endast textkörningar /seedance/generate/ direkt och hoppa över uppladdningssteget.

Seedance-modellfamiljen: 1.5 Pro, 2.0 och 2.5

Seedance är ByteDances text-till-video och bild-till-video-modell. ByteDance lanserade den första Seedance i juni 2025, släpptes Seedance 2.0 i februari 2026, och har sedan dess visat Seedance 2.5. Varje generation driver samma kärnidé ytterligare: filmisk rörelse, starkare promptföljning, scener med flera bilder, bild- och videoreferenser och valfritt inbyggt ljud i en enda rendering. API-guiden täcker de för närvarande stödda Seedance-versioner utan att du behöver sätta upp ByteDances egen plattform.

VersionSläppt av ByteDanceVad det tillför
Seedance 1.5 Pro2025Text- och bild-till-video, upp till 2 guidebilder, valfritt ljud, 480p/720p/1080p. Kopplad till UlazAI idag.
Seedance 2.0februari 2026Multimodala ingångar (text, bild, video, ljud), berättande med flera kameror, samgenerering av inbyggt ljud, längre klipp.
Seedance 2.52026Det senaste steget som ByteDance har visat, syftar till snabbare generering och ytterligare kvalitets- och kontrollvinster.

Samma kod, nyare modell

UlazAI:s offentliga API genererar med bytedance/seedance-1.5-pro idag. Den viktiga delen för utvecklare: när en nyare Seedance-version är aktiverad här återanvänder den samma Bärare auth och den samma generera-och-pröva slutpunkter nedan. Din integration ändras inte – bara modellidentifieraren gör det – så du kan bygga mot denna referens nu och flytta upp familjen senare.

ByteDance och ARK: den officiella modellen, en enhetlig rutt

Människor som söker efter ByteDance Seedance officiella dokumentation eller den Ark Seedance API letar vanligtvis efter två olika saker: själva modellen och ett sätt att faktiskt kalla den. Seedance är ByteDances egen modell, publicerad genom ByteDances Volcano Engine ARK plattform. Den rutten innebär att sätta upp en ARK konto, regionåtkomst och råmodellslutpunkter.

UlazAI sitter framför det som ett tredje parts API-lager. Du får en bärarnyckel, en värd bild uppladdning steg, en delad kreditplånbok och den lilla uppsättningen slutpunkter på den här sidan — ingen ARK onboarding, ingen regional lösning och inget VPN eller kinesiskt telefonnummer för att nå modellen. Om du specifikt sökte ARK API Uppladdning av Seedance-bild, motsvarande här är ett enda samtal: POST /seedance/upload/ returnerar en permanent URL som du hamnar på input_urls på generera (se uppladdningsslutpunkten nedan).

ARK-koncept mappade till denna API

Om du redan läser ByteDances ARK-dokumentation är vokabulären annorlunda men den stegen är desamma. Detta är den direkta översättningen:

På ByteDance ARK Här Vad förändras för dig
ARK-konto, projekt och slutpunktsinställningar En bärarnyckel Ingen plattform onboarding före det första samtalet.
Värd guidebilden själv, skicka en offentlig URL POST /seedance/upload/ Du kan skicka råfilen; svaret ger dig en permanent URL.
Modell-id i förfrågningstexten model fältet Samma idé; endast identifieraren ändras mellan versionerna.
Fråga uppgiften tills den är klar GET /seedance/status/{generation_id}/ Samma undersökningsform, en slutpunkt.

Bild-till-video i två samtal

Detta är hela bilduppladdningsflödet. Det första anropet lagrar bilden och returnerar en URL, det andra samtalet använder den webbadressen som visuell vägledning för videon.

En uppladdad stillbild till vänster matar en sekvens av genererade videorutor till höger 
# 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 skicka in upp till två webbadresser input_urls. Två bilder läses som en början och slutreferens, vilket är det vanliga sättet att hålla en karaktär eller produkt konsekvent över hela klipp. För enbart textgenerering, hoppa över uppladdningssamtalet helt.

Snabb integrationssammanfattning

Auth Bärare API nyckel från /dashboard/ -> API-nycklar
Modell ID bytedance/seedance-1.5-pro
Varaktigheter 4s, 8s, 12s
Upplösningar 480p, 720p, 1080p
Bildförhållanden 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Ingångar Endast Prompt eller prompt plus upp till 2 bildadresser
Röstningsflöde Skapa ett jobb, lagra generation_id, sedan omröstningsstatus tills completed

Offentlig slutpunktssammanfattning

Metod Slutpunkt När man ska använda den
POST /seedance/upload/ Ladda upp en bild först om du vill ha bild-till-video-vägledning
POST /seedance/generate/ Skapa ett Seedance 1.5 Pro-generationsjobb
FÅ /seedance/status/{generation_id}/ Kontrollera om jobbet fortfarande bearbetas, slutförts eller misslyckats

Autentisering

Alla API-förfrågningar kräver en bärartoken:

Authorization: Bearer YOUR_API_KEY

Få en API-nyckel från din instrumentpanel under API-nycklar. Om du fortfarande behöver krediter, gå till paket först.

POST /seedance/upload/

Ladda upp ingångsbilder för bild-till-video-vägledning

Ladda upp en guidebild före generering om du vill att Seedance ska förankra komposition, karaktärsinramning eller sceninställning. Svaret ger dig en permanent URL att gå in på input_urls.

Begär rubriker

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

Formulärdataparametrar

fil * (fil)

JPG, PNG eller WebP, upp till 10 MB.

Framgångssvar (200)

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

Exempel på användning (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/

Skapa en Seedance 1.5 Pro-genereringsuppgift

Skicka antingen den förenklade nyttolasten nedan eller den explicita model plus input format. Använd den förenklade versionen om du bara behöver den offentliga Seedance-rutten med prompt, valfria guidebilder och utdatainställningar.

Begäran text (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
}

Begäran text (modell/inmatningsstil)

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

Parametrar

prompt * (sträng)

3 till 2500 tecken som beskriver scenen, rörelsen, inramningen och ljudavsikten.

input_urls (array)

Valfritt. Upp till 2 bildadresser för bild-till-video-vägledning.

aspect_ratio (sträng)

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

upplösning (sträng)

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

varaktighet (sträng)

4, 8 eller 12 sekunder.

fixed_lens (boolesk)

Aktivera för en mer stabil kameravy.

generate_audio (boolesk)

Aktivera synkroniserad ljudgenerering. Detta ökar kreditanvändningen.

prompt_directory_optin (boolesk)

Valfritt. Dela kvalificerade prompt till prompt-katalogen och tillämpa en rabatt när det stöds.

Framgångssvar (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 för enkätuppgift

Fråga denna slutpunkt tills jobbet lämnar processing. Vid framgång får du tillbaka en video-URL; på misslyckande du bör inspektera felet och försöka igen med en korrigerad nyttolast.

Bearbetar svar

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

Framgångssvar (200)

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

Kodexempel: cURL, Python och JavaScript

Hela flödet är skicka → lagra generation_id → omröstningsstatus. Här är genereringsanropet i tre vanliga stackar; byt in din egen nyckel och 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 (förfrågningar)

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 (hämta)

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

Användningsflöde

  1. Ladda upp en eller två guidebilder med /seedance/upload/ endast om du behöver bild-till-video-vägledning.
  2. Ring /seedance/generate/ med din prompt, utdatainställningar och valfritt input_urls.
  3. Förvara det returnerade generation_id.
  4. Omröstning /seedance/status/{generation_id}/ tills status blir completed.
  5. Använd den returnerade video_url för att ladda ner, bädda in eller skicka den slutliga tillgången till ditt eget arbetsflöde.

Felkoder

400 Ogiltiga begärandeparametrar

401 Autentisering misslyckades (saknade eller ogiltig API-nyckel)

402 Otillräckliga krediter

429 Prisgränsen har överskridits

500 Internt serverfel

Prissättning och prisgränser

Seedance-fakturering på UlazAI körs på krediter, så kostnaden skalas med upplösning och varaktighet snarare än en fast ränta per sekund. Använd detta som en planeringsguide; livekreditkostnaden visas i paket och på begäran.

UtgångTypisk användningKostnadsdrivare
480pUtkast och snabba iterationerLägsta krediter per sekund
720pSocialt redo klippMittpoäng per sekund
1080pSlutleveransHögsta krediter per sekund; längre tider kostar mer

Prisgränser och 429-hantering: om du skickar in många jobb parallellt kan du få 429 Rate limit exceeded. Behandla API som jobbbaserad: skicka in, lagra generation_id, och enkät /seedance/status/{generation_id}/ var 5-10:e sekund istället för att hamra generera. På en 429, backa exponentiellt (till exempel 2s, 4s, 8s) innan du försöker igen.

Seedance 1.5 pro vs Seedance 2.0: denna referens omfattar bytedance/seedance-1.5-pro, modellen som för närvarande är kopplad till Video Studio. ByteDance har sedan dess introducerat Seedance 2.0 som nästa generation; när den är aktiverad här använder den samma generera-och-poll-flöde och samma autentisering, så integreringskoden ändras inte - bara modellidentifieraren gör det.

Vanliga frågor

Stöder UlazAI Seedance API Seedance 2.0 och 2.5?

API genererar med bytedance/seedance-1.5-pro idag. ByteDance släppte Seedance 2.0 i februari 2026 och har sedan dess visat 2.5. När en nyare version är aktiverad här använder den samma Bearer-auth och samma generera-och-poll-slutpunkter, så din integrationskod ändras inte - bara modellidentifieraren gör det.

Hur relaterar UlazAI till ByteDances officiella Seedance / ARK API?

Seedance är ByteDances egen modell, som erbjuds genom ByteDances Volcano Engine ARK-plattform. UlazAI är ett API-lager från tredje part som kör Seedance bakom en förenklad rutt med en enda bärarnyckel, värdbildsuppladdning och en delad kreditplånbok – inga ARK-konton eller råmodellslutpunkter att hantera.

Hur laddar jag upp en bild för Seedance bild-till-video?

Skicka bilden som multipart/form-data till POST /seedance/upload/ med din bärarnyckel. Svaret returnerar en permanent URL; skicka det (upp till två) i input_urls array på POST /seedance/generate/. Endast text-prompt hoppar över uppladdningssteget.

Hur mycket kostar Seedance API?

Fakturering körs på krediter, så kostnaden skalar med upplösning och varaktighet. Ett kort 480p-utkast kostar minst krediter; en 12-sekunders 1080p-rendering med ljud kostar mest. Den exakta kostnaden syns paket och igen som credits_used i genereringssvaret.

Är Seedance tillgängligt över hela världen via API?

Ja. Du ringer UlazAI:s värdbaserade HTTPS-slutpunkter med en bärarnyckel, så ingen VPN, regional lösning eller kinesiskt telefonnummer behövs. Alla servrar som kan göra en autentiserad HTTPS-förfrågan kan skicka jobb och omröstning för resultat.

Vart ska man gå härnäst

Köp krediter Seedance 1.5 Pro landning Seedance 2 prissättning Video API dokument API referensindex Öppna Seedance i Video Studio