Naar inhoud
UlazAI

UlazAI ontwikkelaarsdocumentatie

Seedance API-documentatie: genereren, status, 1080p en prijzen

Prijzen Dashboard Beeldstudio

Seedance 1.5 Pro-referentie

Seedance API-documentatie

Om de Seedance API, authenticeer met een Bearer-sleutel, gebruik POST /seedance/generate/ om banen te creëren en te peilen GET /seedance/status/{generation_id}/ totdat de video klaar is. UlazAI ondersteunt momenteel Seedance 1.5 Pro-uitvoer in 480p, 720p en 1080p met een duur van 4, 8 of 12 seconden.

Kerneindpunten

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Huidige mogelijkheden

Tekst-naar-video en afbeelding-naar-video

Maximaal 2 gidsafbeeldingen

Optionele native audio

Volgende trajecten

Koop kredieten

Zie Seedance-landing

Open canonieke video API-documenten

Tip

Deze pagina beantwoordt de volledige ontwikkelaarsstroom in het eerste scherm: het genereren van eindpunt, statusonderzoek, 1080p-ondersteuning, Bearer-authenticatie en de prijsroute.

Gebruik /seedance/upload/ alleen als u beeldgestuurde videogeneratie nodig heeft. Voor alleen-tekstuitvoeringen kunt u bellen /seedance/generate/ direct en sla de uploadstap over.

De Seedance-modelfamilie: 1.5 Pro, 2.0 en 2.5

Seedance is het tekst-naar-video- en beeld-naar-video-model van ByteDance. ByteDance lanceerde de eerste Seedance in juni 2025, vrijgegeven Seedance 2.0 in februari 2026, en is sindsdien getoond Seedance 2.5. Elk generatie duwt hetzelfde kernidee verder: filmische beweging, sterkere prompt-following, scènes met meerdere shots, afbeeldings- en videoreferenties en optionele native audio in één render. De API-handleiding behandelt de momenteel ondersteunde Seedance-versies zonder dat u het eigen platform van ByteDance hoeft op te zetten.

VersieUitgegeven door ByteDanceWat het toevoegt
Seedance 1.5 Pro2025Tekst- en beeld-naar-video, maximaal 2 gidsafbeeldingen, optionele audio, 480p/720p/1080p. Vandaag aangesloten op UlazAI.
Seedance 2.0februari 2026Multimodale input (tekst, beeld, video, audio), storytelling met meerdere camera's, co-generatie van native audio, langere clips.
Seedance 2.52026De nieuwste stap die ByteDance heeft laten zien, gericht op snellere generatie en verdere kwaliteits- en controlewinst.

Zelfde code, nieuwer model

UlazAI's openbare API genereert met bytedance/seedance-1.5-pro vandaag. Het belangrijkste onderdeel voor ontwikkelaars: wanneer hier een nieuwere Seedance-versie wordt ingeschakeld, wordt de hetzelfde Dragerauthenticatie en de hetzelfde genereer-en-poll-eindpunten hieronder. Uw integratie verandert niet, alleen de model-ID wel je kunt nu op deze referentie voortbouwen en later de familie opschuiven.

ByteDance en ARK: het officiële model, één uniforme route

Mensen zoeken ByteDance Seedance officiële documentatie of de Bakzaad API zijn meestal op zoek naar twee verschillende dingen: het model zelf, en een manier om het daadwerkelijk te noemen. Seedance is van ByteDance eigen model, gepubliceerd via ByteDance's Volcano Engine ARK platform. Die route betekent het opzetten van een ARK account-, regiotoegang en onbewerkte modeleindpunten.

UlazAI zit daarvoor als een API-laag van derden. Jij krijgt één dragersleutel, een gehost afbeelding uploaden stap, een gedeelde kredietportemonnee en de kleine set eindpunten op deze pagina – geen ARK onboarding, geen regionale oplossing en geen VPN- of Chinees telefoonnummer om het model te bereiken. Als je specifiek hebt gezocht ARK API Seedance-afbeelding geüpload, het equivalent hier is een enkele oproep: POST /seedance/upload/ retourneert een permanente URL waar u naartoe gaat input_urls bij het genereren (zie het uploadeindpunt hieronder).

ARK-concepten toegewezen aan deze API

Als je de ARK-documentatie van ByteDance al hebt gelezen, is de woordenschat anders, maar de stappen zijn hetzelfde. Dit is de directe vertaling:

Op ByteDance ARK Hier Wat verandert er voor jou
ARK-account, project en eindpunt instellen Eén Bearer-sleutel Geen platform-onboarding vóór het eerste gesprek.
Host de gidsafbeelding zelf, geef een openbare URL door POST /seedance/upload/ U kunt het onbewerkte bestand verzenden; het antwoord geeft u een permanente URL.
Model-ID in de aanvraagtekst model veld Hetzelfde idee; alleen de ID verandert tussen versies.
Poll de taak totdat deze is voltooid GET /seedance/status/{generation_id}/ Dezelfde pollingvorm, één eindpunt.

Beeld-naar-video in twee gesprekken

Dit is de hele stroom van het uploaden van afbeeldingen. De eerste oproep slaat de afbeelding op en retourneert een URL, de tweede oproep gebruikt die URL als visuele begeleiding voor de video.

Eén geüpload stilstaand beeld aan de linkerkant voedt een reeks gegenereerde videoframes aan de rechterkant 
# 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"
      }'

U kunt maximaal twee URL's doorgeven input_urls. Twee afbeeldingen worden als begin gelezen en eindreferentie, wat de gebruikelijke manier is om een personage of product consistent te houden in de hele wereld clip. Als u alleen tekst wilt genereren, slaat u de uploadaanroep volledig over.

Snel integratieoverzicht

Aut Drager API sleutel van /dashboard/ -> API-toetsen
Model-ID bytedance/seedance-1.5-pro
Duur 4s, 8s, 12s
Resoluties 480p, 720p, 1080p
Beeldverhoudingen 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Ingangen Alleen Prompt, of prompt plus maximaal 2 afbeeldings-URL's
Stemmingsstroom Creëer een baan, sla op generation_iden vervolgens de status opvragen tot completed

Samenvatting van het openbare eindpunt

Methode Eindpunt Wanneer moet u het gebruiken?
POST /seedance/upload/ Upload eerst een afbeelding als u begeleiding van beeld naar video wilt
POST /seedance/generate/ Maak een Seedance 1.5 Pro-generatietaak
KRIJG /seedance/status/{generation_id}/ Controleer of de taak nog steeds wordt verwerkt, voltooid of mislukt

Authenticatie

Voor alle API-aanvragen is een Bearer-token vereist:

Authorization: Bearer YOUR_API_KEY

Haal een API-sleutel uit uw dashboard eronder API-toetsen. Als je nog credits nodig hebt, ga dan naar pakketten eerst.

POST /seedance/upload/

Upload invoerafbeeldingen voor begeleiding van beeld naar video

Upload vóór het genereren een gidsafbeelding als u wilt dat Seedance de compositie, karakterkaders of scène-instellingen verankert. Het antwoord geeft u een permanente URL waar u naartoe kunt gaan input_urls.

Vraag headers aan

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

Formuliergegevensparameters

bestand * (bestand)

JPG, PNG of WebP, tot 10 MB.

Succesreactie (200)

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

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

Maak een Seedance 1.5 Pro-generatietaak

Stuur de vereenvoudigde payload hieronder of de expliciete model plus input formaat. Gebruik de vereenvoudigde versie als u alleen de openbare Seedance-route met prompt, optionele gidsafbeeldingen en uitvoerinstellingen nodig heeft.

Verzoektekst (eenvoudig)

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

Verzoektekst (model/invoerstijl)

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

Parameters

prompt * (tekenreeks)

3 tot 2500 tekens die de scène, beweging, kadrering en audio-intentie beschrijven.

input_urls (matrix)

Optioneel. Maximaal 2 afbeeldings-URL's voor begeleiding van afbeelding naar video.

aspect_ratio (tekenreeks)

Eén van: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.

resolutie (tekenreeks)

Eén van: 480p, 720p, 1080p.

duur (tekenreeks)

4, 8 of 12 seconden.

fixed_lens (Booleaans)

Inschakelen voor een stabieler camerabeeld.

generate_audio (Booleaans)

Schakel gesynchroniseerde audiogeneratie in. Dit verhoogt het kredietgebruik.

prompt_directory_optin (Booleaans)

Optioneel. Deel in aanmerking komende prompts met de promptdirectory en pas een korting toe als dit wordt ondersteund.

Succesreactie (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."
}
KRIJG /seedance/status/{generation_id}/

Status van taak opvragen

Poll dit eindpunt totdat de taak vertrekt processing. Bij succes krijg je een video-URL terug; op mislukking u moet de fout inspecteren en het opnieuw proberen met een gecorrigeerde payload.

Reactie verwerken

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

Succesreactie (200)

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

Codevoorbeelden: cURL, Python en JavaScript

De volledige stroom is indienen → opslaan generation_id → opiniepeilingstatus. Hier is de gegenereerde oproep in drie gemeenschappelijke stapels; ruil uw eigen sleutel in en prompt.

krul

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

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

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

Gebruiksstroom

  1. Upload een of twee gidsafbeeldingen met /seedance/upload/ alleen als u beeld-naar-video-begeleiding nodig heeft.
  2. Bel /seedance/generate/ met uw prompt, uitvoerinstellingen en optioneel input_urls.
  3. Bewaar het geretourneerde generation_id.
  4. Opiniepeiling /seedance/status/{generation_id}/ tot status wordt completed.
  5. Gebruik de geretourneerde video_url om het uiteindelijke item te downloaden, in te sluiten of door te geven aan uw eigen workflow.

Foutcodes

400 Ongeldige verzoekparameters

401 Verificatie mislukt (ontbrekende of ongeldige API-sleutel)

402 Onvoldoende kredieten

429 Tarieflimiet overschreden

500 Interne serverfout

Prijzen en tarieflimieten

Seedance-facturering op UlazAI werkt op basis van credits, dus de kosten worden geschaald op basis van de resolutie en duur in plaats van op basis van een vast tarief per seconde. Gebruik dit als planningsgids; de live kredietkosten worden weergegeven in pakketten en op aanvraagtijd.

UitvoerTypisch gebruikKostendrijver
480pConcepten en snelle iteratiesLaagste credits per seconde
720pClips die geschikt zijn voor sociale mediaMidcredits per seconde
1080pLaatste leveringHoogste credits per seconde; langere looptijden kosten meer

Tarieflimieten en 429-afhandeling: als u veel opdrachten tegelijk indient, kunt u ontvangen 429 Rate limit exceeded. Behandel de API als taakgebaseerd: indienen, opslaan generation_id, en opiniepeiling /seedance/status/{generation_id}/ elke 5-10 seconden in plaats van te hameren. Op een 429, ga exponentieel terug (bijvoorbeeld 2s, 4s, 8s) voordat u het opnieuw probeert.

Seedance 1.5 Pro versus Seedance 2.0: deze referentie omvat bytedance/seedance-1.5-pro, het model dat momenteel is aangesloten op Video Studio. ByteDance heeft sindsdien Seedance 2.0 geïntroduceerd als de volgende generatie; als het hier is ingeschakeld, gebruikt het dezelfde stroom voor genereren en peilen en dezelfde authentificatie, dus de integratiecode verandert niet – alleen de model-ID verandert.

Veelgestelde vragen

Ondersteunt de UlazAI Seedance API Seedance 2.0 en 2.5?

De API genereert met bytedance/seedance-1.5-pro vandaag. ByteDance bracht Seedance 2.0 uit in februari 2026 en heeft sindsdien 2.5 laten zien. Wanneer hier een nieuwere versie wordt ingeschakeld, wordt dezelfde Bearer-authenticatie en dezelfde genereren-en-poll-eindpunten gebruikt, zodat uw integratiecode niet verandert; alleen de model-ID verandert.

Hoe verhoudt UlazAI zich tot ByteDance's officiële Seedance / ARK API?

Seedance is ByteDance's eigen model, aangeboden via ByteDance's Volcano Engine ARK-platform. UlazAI is een API-laag van derden die Seedance achter één vereenvoudigde route uitvoert met een enkele Bearer-sleutel, gehoste afbeeldingsupload en een gedeelde kredietportemonnee - geen ARK-account of onbewerkte modeleindpunten om te beheren.

Hoe upload ik een afbeelding voor Seedance image-to-video?

Stuur de afbeelding als meerdelige/formuliergegevens naar POST /seedance/upload/ met uw Bearer-sleutel. Het antwoord retourneert een permanente URL; geef het door (maximaal twee) in de input_urls array aan POST /seedance/generate/. prompts met alleen tekst slaan de uploadstap over.

Hoeveel kost de Seedance API?

Facturering vindt plaats op basis van tegoeden, dus de kosten variëren afhankelijk van de resolutie en duur. Een korte 480p-versie kost de minste credits; een 12 seconden durende 1080p-weergave met audio kost het meest. De exacte kosten verschijnen in pakketten en opnieuw als credits_used in de gegenereerde respons.

Is Seedance wereldwijd verkrijgbaar via de API?

Ja. U belt de gehoste HTTPS-eindpunten van UlazAI met een Bearer-sleutel, dus er is geen VPN, regionale oplossing of Chinees telefoonnummer nodig. Elke server die een geverifieerd HTTPS-verzoek kan indienen, kan taken indienen en naar resultaten peilen.

Waar moet je heen?

Koop kredieten Seedance 1.5 Pro-landing Seedance 2-prijzen Video API-documentatie API referentie-index Open Seedance in Videostudio