Ugrás a tartalomra
UlazAI

UlazAI fejlesztői dokumentumok

Seedance API dokumentáció: generálás, állapot, 1080p és árazás

Árképzés Műszerfal Képstúdió

Seedance 1.5 Pro referencia

Seedance API dok

Használatához a Seedance API, Bearer kulccsal hitelesíteni, használni POST /seedance/generate/ munkahelyteremtésre és közvélemény-kutatásra GET /seedance/status/{generation_id}/ amíg el nem készül a videó. A UlazAI jelenleg támogatja a Seedance 1.5 Pro kimenetet 480p, 720p és 1080p 4, 8 vagy 12 másodperces időtartammal.

Alapvető végpontok

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Jelenlegi képességek

Szövegből videóba és képből videóba

Akár 2 útmutató kép

Opcionális natív hang

Következő útvonalak

Vásároljon krediteket

Lásd Seedance landing

Nyissa meg a kanonikus videó API dokumentumait

Tipp

Ez az oldal válaszol a teljes fejlesztői folyamatra az első képernyőn: a végpont generálása, az állapotlekérdezés, az 1080p támogatás, a hordozó hitelesítés és az árképzési útvonal.

Használja /seedance/upload/ csak akkor, ha képvezérelt videógenerálásra van szüksége. Csak szöveges futtatás esetén hívjon /seedance/generate/ közvetlenül, és hagyja ki a feltöltés lépését.

A Seedance modellcsalád: 1.5 Pro, 2.0 és 2.5

A Seedance a ByteDance szöveg-videó és kép-videó modellje. A ByteDance 2025 júniusában indította el az első Seedance-t, kiadták Seedance 2.0 2026 februárjában, és azóta megmutatta Seedance 2.5. Mindegyik generáció ugyanazt az alapötletet tolja tovább: filmes mozgás, erősebb prompt-követés, több felvételből álló jelenetek, kép- és videóhivatkozások, valamint opcionális natív hang egyetlen renderelésben. A API útmutató lefedi a jelenleg támogatottakat Seedance verziók anélkül, hogy be kellene állítania a ByteDance saját platformját.

VerzióA ByteDance adta kiMit ad hozzá
Seedance 1.5 Pro2025Szövegből és képből videóba, akár 2 útmutató kép, opcionális hang, 480p/720p/1080p. Ma bekötve a UlazAI-be.
Seedance 2.02026. febrMultimodális bemenetek (szöveg, kép, videó, hang), több kamerás történetmesélés, natív audio kogeneráció, hosszabb klipek.
Seedance 2.52026A ByteDance legújabb lépése a gyorsabb generálást, valamint a további minőség- és ellenőrzési előnyöket célozza meg.

Ugyanaz a kód, újabb modell

A UlazAI nyilvános API-je ezzel generál bytedance/seedance-1.5-pro ma. A fejlesztők számára fontos rész: ha itt engedélyezve van egy újabb Seedance verzió, akkor újra felhasználja a ugyanaz Tartós hitelesítés és a ugyanaz gener-and-poll végpontokat alább. Az integráció nem változik – csak a modellazonosító változtat – így van most építhetsz erre a hivatkozásra, és később léphetsz fel a családdal.

ByteDance és ARK: a hivatalos modell, egy egységes útvonal

Kereső emberek ByteDance Seedance hivatalos dokumentáció vagy a Bárka vetőmag API általában két különböző dolgot keresnek: magát a modellt, és egy módot, hogy ténylegesen nevezzük. A Seedance a ByteDance-é saját modell, amely a ByteDance Volcano Engine-jén keresztül jelent meg ARK platformon. Ez az útvonal egy ARK felállítását jelenti fiók, régió hozzáférés és nyers modell végpontok.

A UlazAI előtt ül, mint egy harmadik féltől származó API réteg. Megkapod egy hordozókulcs, a házigazdája képfeltöltés lépés, egy megosztott hiteltárca és az ezen az oldalon található kis végpontkészlet – nincs ARK beépítés, nincs regionális megoldás, és nincs VPN vagy kínai telefonszám a modell eléréséhez. Ha konkrétan kerestél ARK API Seedance képfeltöltés, ennek megfelelője egyetlen hívás: POST /seedance/upload/ egy állandó URL-t ad vissza, amelybe belép input_urls generáláskor (lásd lent a feltöltési végpontot).

Az ARK koncepciók ehhez a API-hez vannak leképezve

Ha már olvasta a ByteDance ARK dokumentációját, akkor a szókincs más, de a lépései ugyanazok. Ez a közvetlen fordítás:

A ByteDance ARK-on itt Mi változik az Ön számára
ARK fiók, projekt és végpont beállítása Egy hordozó kulcs Nincs platform beépítés az első hívás előtt.
Saját maga tárolja az útmutató képét, és adjon meg egy nyilvános URL-t POST /seedance/upload/ Elküldheti a nyers fájlt; a válasz állandó URL-t ad.
Modellazonosító a kérelem törzsében model mezőben Ugyanaz a gondolat; csak az azonosító változik a verziók között.
Kérdezze le a feladatot, amíg be nem fejeződik GET /seedance/status/{generation_id}/ Ugyanaz a lekérdezési forma, egy végpont.

Képről videóra két hívásban

Ez a teljes képfeltöltés folyamata. Az első hívás tárolja a képet, és egy URL-t ad vissza, a második hívás ezt az URL-t használja vizuális útmutatásként a videóhoz.

Egy feltöltött állókép a bal oldalon, a jobb oldalon generált videokockák sorozatával 
# 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"
      }'

Legfeljebb két URL-t adhat át input_urls. Kezdésként két kép olvasható és végi hivatkozás, ami a szokásos módja annak, hogy egy karakter vagy termék következetes legyen a klip. Csak szöveges generálás esetén hagyja ki teljesen a feltöltési hívást.

Gyors integrációs összefoglaló

Auth Bearer API kulcs tól /dashboard/ -> API kulcsok
Modellazonosító bytedance/seedance-1.5-pro
Időtartamok 4s, 8s, 12s
Határozatok 480p, 720p, 1080p
Képarányok 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Bemenetek Csak a Prompt vagy a prompt plusz legfeljebb 2 kép URL-je
Lekérdezési folyamat Hozzon létre munkát, tárolja generation_id, majd szavazás állapota ig completed

Nyilvános végpont-összefoglaló

Módszer Végpont Mikor kell használni
POST /seedance/upload/ Először töltsön fel egy képet, ha képről videóra útmutatást szeretne
POST /seedance/generate/ Hozzon létre egy Seedance 1.5 Pro generációs munkát
GET /seedance/status/{generation_id}/ Ellenőrizze, hogy a feladat feldolgozása még folyamatban van, befejeződött-e vagy meghiúsult

Hitelesítés

Minden API kéréshez hordozó token szükséges:

Authorization: Bearer YOUR_API_KEY

Szerezzen be egy API kulcsot a műszerfal alatt API kulcsok. Ha továbbra is kreditekre van szüksége, menjen ide csomagokat először.

POST /seedance/upload/

Töltsön fel bemeneti képeket a kép-videó útmutatáshoz

Töltsön fel egy útmutató képet a generálás előtt, ha azt szeretné, hogy a Seedance rögzítse a kompozíciót, a karakterkeretezést vagy a jelenet beállítását. A válasz állandó URL-t ad, amelyre át kell lépnie input_urls.

Kérelem fejlécek

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

Űrlapadatok paraméterei

fájlt * (fájl)

JPG, PNG vagy WebP, legfeljebb 10 MB.

Sikeres válasz (200)

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

Használati példa (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/

Hozzon létre egy Seedance 1.5 Pro generációs feladatot

Küldje el vagy az alábbi egyszerűsített hasznos adatot, vagy az explicit model plusz input formátumban. Használja az egyszerűsített verziót, ha csak a nyilvános Seedance útvonalra van szüksége prompt-vel, opcionális útmutatóképekkel és kimeneti beállításokkal.

Kérelem törzse (egyszerű)

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

Kérelem törzse (modell/beviteli stílus)

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

Paraméterek

prompt * (karakterlánc)

3-2500 karakter, amely leírja a jelenetet, a mozgást, a keretezést és az audio szándékot.

input_urls (tömb)

Választható. Legfeljebb 2 kép URL-címe a képről videóra útmutatáshoz.

aspect_ratio (karakterlánc)

Az egyik: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.

felbontásban (karakterlánc)

Az egyik: 480p, 720p, 1080p.

időtartama (karakterlánc)

4, 8 vagy 12 másodperc.

fixed_lens (boolean)

Engedélyezze a stabilabb kameranézet érdekében.

generate_audio (boolean)

Engedélyezze a szinkronizált hanggenerálást. Ez növeli a hitelfelhasználást.

prompt_directory_optin (boolean)

Választható. Oszd meg a jogosult prompt-ket a prompt könyvtárban, és alkalmazz kedvezményt, ha támogatott.

Sikeres válasz (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}/

Szavazási feladat állapota

Kérdezze le ezt a végpontot a feladat távozásáig processing. Siker esetén visszakapja a videó URL-jét; kudarcról meg kell vizsgálnia a hibát, és újra kell próbálnia egy javított rakományt.

Válasz feldolgozása

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

Sikeres válasz (200)

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

Kódpéldák: cURL, Python és JavaScript

A teljes folyamat a küldés → tárolja generation_id → szavazás állapota. Itt van a generálási hívás három közös veremben; cserélje ki a saját kulcsát és a prompt-t.

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 (kérések)

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 (lekérés)

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

Használati folyamat

  1. Töltsön fel egy vagy két útmutatóképet /seedance/upload/ csak akkor, ha kép-videó útmutatásra van szüksége.
  2. Hívjon /seedance/generate/ a prompt, a kimeneti beállítások és az opcionális input_urls.
  3. Tárolja a visszaküldöttet generation_id.
  4. Poll /seedance/status/{generation_id}/ amíg status válik completed.
  5. Használd a visszaküldöttet video_url letöltheti, beágyazhatja vagy átadhatja a végső eszközt a saját munkafolyamatába.

Hibakódok

400 Érvénytelen kérési paraméterek

401 A hitelesítés nem sikerült (hiányzó vagy érvénytelen API kulcs)

402 Elégtelen kredit

429 A díjkorlát túllépve

500 Belső szerver hiba

Ár- és díjkorlátok

A UlazAI vetőmag számlázása krediteken működik, így a költségek a felbontás és az időtartam alapján skálázódnak, nem pedig fix másodpercenkénti árfolyamon. Használja ezt tervezési útmutatóként; az élő hitelköltség látható csomagokat és kérésre.

KimenetTipikus használatKöltséghajtó
480pPiszkozatok és gyors iterációkLegalacsonyabb kredit másodpercenként
720pKözösségi használatra kész klipekKözép kredit másodpercenként
1080pVégső szállításLegmagasabb kredit másodpercenként; a hosszabb időtartamok többe kerülnek

Díjkorlátok és 429-es kezelés: ha párhuzamosan sok munkát ad be, akkor kaphat 429 Rate limit exceeded. A API-t munkaalapúként kezelje: küldje be, tárolja a generation_id, és szavazás /seedance/status/{generation_id}/ 5-10 másodpercenként kalapálás helyett generál. Az a 429, exponenciálisan hátráljon vissza (például 2s, 4s, 8s), mielőtt újra próbálkozna.

Seedance 1.5 pro vs Seedance 2.0: ez a hivatkozás lefedi bytedance/seedance-1.5-pro, a jelenleg a Video Stúdióhoz csatlakoztatott modell. A ByteDance azóta bemutatta a Seedance 2.0-t, mint a következő generációt; Ha itt engedélyezve van, ugyanazt a generálás és lekérdezés folyamatát és ugyanazt a hitelesítést használja, így az integrációs kód nem változik – csak a modellazonosító változik.

Gyakran ismételt kérdések

A UlazAI Seedance API támogatja a Seedance 2.0 és 2.5 verziókat?

A API ezzel generál bytedance/seedance-1.5-pro ma. A ByteDance 2026 februárjában adta ki a Seedance 2.0-t, és azóta a 2.5-ös verziót is bemutatta. Ha itt engedélyezve van egy újabb verzió, az ugyanazt a hordozó hitelesítést és ugyanazokat a generálási és lekérdezési végpontokat használja, így az integrációs kód nem változik – csak a modellazonosító.

Hogyan kapcsolódik a UlazAI a ByteDance hivatalos Seedance / ARK API-hez?

A Seedance a ByteDance saját modellje, amelyet a ByteDance Volcano Engine ARK platformján keresztül kínálnak. A UlazAI egy harmadik féltől származó API réteg, amely egy egyszerűsített útvonal mögött futtatja a Seedance-t egyetlen Bearer kulccsal, tárolt képfeltöltéssel és megosztott hiteltárcával – nincs kezelendő ARK-fiók vagy nyers modellvégpontok.

Hogyan tölthetek fel képet a Seedance képről videóra?

Küldje el a képet többrészes/forma-adatként a címre POST /seedance/upload/ a Tartókulcsoddal. A válasz egy állandó URL-t ad vissza; adja át (legfeljebb kettőt) a input_urls tömb be POST /seedance/generate/. A csak szöveges promptok kihagyják a feltöltési lépést.

Mennyibe kerül a Seedance API?

A számlázás jóváírással történik, így a költségek a felbontás és az időtartam függvényében skálázódnak. Egy rövid, 480p-s piszkozat kerül a legkevesebb kreditbe; egy 12 másodperces 1080p renderelés hanggal kerül a legtöbbbe. A pontos költség látható csomagokat és újra mint credits_used a válasz generálásában.

A Seedance világszerte elérhető a API-n keresztül?

Igen. A UlazAI hostolt HTTPS-végpontjait hordozókulccsal hívja, így nincs szükség VPN-re, regionális megoldásra vagy kínai telefonszámra. Bármely szerver, amely hitelesített HTTPS-kérelmet tud küldeni, küldhet feladatokat és lekérdezheti az eredményeket.

Merre tovább

Vásároljon krediteket Seedance 1.5 Pro leszállás Seedance 2 árazás Videó API dok API referencia index Nyissa meg a Seedance-t a Video Stúdióban