Siirry sisältöön
UlazAI

UlazAI kehittäjädokumentit

Seedance API -dokumentaatio: luo, tila, 1080p ja hinnoittelu

Hinnoittelu Kojelauta Kuvastudio

Seedance 1.5 Pro -viite

Seedance API docs

Käyttääksesi Seedance API, todenna siirtotieavaimella, käytä POST /seedance/generate/ luoda työpaikkoja ja tehdä mielipidekyselyjä GET /seedance/status/{generation_id}/ kunnes video on valmis. UlazAI tukee tällä hetkellä Seedance 1.5 Pro -lähtöä 480p, 720p ja 1080p 4, 8 tai 12 sekunnin kestoisin.

Ydinpäätepisteet

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Nykyiset ominaisuudet

Tekstistä videoksi ja kuvasta videoksi

Jopa 2 opaskuvaa

Valinnainen natiivi ääni

Seuraavat reitit

Osta krediittejä

Katso Seedance-lasku

Avaa kanoninen video API-dokumentit

Vihje

Tämä sivu vastaa täydelliseen kehittäjävirtaan ensimmäisessä näytössä: luo päätepiste, tilakysely, 1080p-tuki, siirtotietodennus ja hinnoittelureitti.

Käytä /seedance/upload/ vain silloin, kun tarvitset kuvaohjattua videontuotantoa. Jos tarvitset vain tekstiviestejä, soita /seedance/generate/ suoraan ja ohita latausvaihe.

Seedance-malliperhe: 1.5 Pro, 2.0 ja 2.5

Seedance on ByteDancen tekstistä videoksi ja kuvasta videoksi -malli. ByteDance julkaisi ensimmäisen Seedancen kesäkuussa 2025, vapautettu Seedance 2.0 helmikuussa 2026, ja on sen jälkeen näyttänyt Seedanssi 2.5. Jokainen sukupolvi ajaa samaa ydinideaa eteenpäin: elokuvamainen liike, vahvempi prompt-seuraus, usean otoksen kohtaukset, kuva- ja videoviittaukset sekä valinnainen natiiviääni yhdessä renderöinnissa. API-opas kattaa tällä hetkellä tuetut Seedance-versiot ilman, että sinun on määritettävä ByteDancen oma alusta.

VersioJulkaisija ByteDanceMitä se lisää
Seedance 1.5 Pro2025Tekstistä ja kuvasta videoon, jopa 2 opaskuvaa, valinnainen ääni, 480p/720p/1080p. Kytketty UlazAI:ään tänään.
Seedance 2.0Helmikuu 2026Multimodaaliset tulot (teksti, kuva, video, ääni), usean kameran tarinankerronta, alkuperäisen äänen yhteistuotanto, pidemmät leikkeet.
Seedance 2.52026ByteDancen uusin askel, jonka tavoitteena on nopeampi sukupolvi ja lisää laatu- ja valvontahyötyjä.

Sama koodi, uudempi malli

UlazAI:n julkinen API luo bytedance/seedance-1.5-pro tänään. Tärkeä osa kehittäjille: kun uudempi Seedance-versio on otettu käyttöön tässä, se käyttää uudelleen sama Haltijatodistus ja sama gener-and-poll -päätepisteet alla. Integraatiosi ei muutu – vain mallin tunniste muuttuu – niin voit rakentaa tätä viittausta vasten nyt ja muuttaa perhettä myöhemmin.

ByteDance ja ARK: virallinen malli, yksi yhtenäinen reitti

Ihmiset etsivät ByteDance Seedancen virallinen dokumentaatio tai Arkin kylvö API etsivät yleensä kahta eri asiaa: itse mallia ja tapaa kutsua sitä. Seedance on ByteDancen oma malli, julkaistu ByteDancen Volcano Enginen kautta ARK alusta. Tämä reitti tarkoittaa ARK:n perustamista tili, aluekäyttö ja raakamallin päätepisteet.

UlazAI on sen edessä kolmannen osapuolen API-kerroksena. Saat yksi siirtoavain, isännöi kuvan lataus vaihe, jaettu luottolompakko ja pieni joukko päätepisteitä tällä sivulla – ei ARK:ia käyttöönotto, ei alueellista ratkaisua eikä VPN- tai kiinalaista puhelinnumeroa mallin tavoittamiseen. Jos olet erityisesti etsinyt ARK API Seedance-kuvan lataus, vastaava tässä on yksi puhelu: POST /seedance/upload/ palauttaa pysyvän URL-osoitteen, johon pudotat input_urls luomisen yhteydessä (katso lähetyksen päätepiste alla).

ARK-konseptit on kartoitettu tähän API:hen

Jos olet jo lukenut ByteDancen ARK-dokumentaation, sanasto on erilainen, mutta vaiheet ovat samat. Tämä on suora käännös:

ByteDance ARK:ssa Tässä Mikä muuttuu sinulle
ARK-tilin, projektin ja päätepisteen asetukset Yksi Bearer-avain Ei alustan käyttöönottoa ennen ensimmäistä puhelua.
Isännöi opaskuva itse, välitä julkinen URL-osoite POST /seedance/upload/ Voit lähettää raakatiedoston; vastaus antaa sinulle pysyvän URL-osoitteen.
Mallin tunnus pyynnön tekstiosassa model kenttä Sama idea; vain tunniste vaihtuu versioiden välillä.
Tee kysely, kunnes tehtävä on valmis GET /seedance/status/{generation_id}/ Sama kyselymuoto, yksi päätepiste.

Kuvasta videoon kahdessa puhelussa

Tämä on koko kuvan latausprosessi. Ensimmäinen kutsu tallentaa kuvan ja palauttaa URL-osoitteen, toinen kutsu käyttää tätä URL-osoitetta visuaalisena ohjeena videolle.

Yksi ladattu still-kuva vasemmalla syöttää sarjan luotuja videoruutuja oikealla 
# 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"
      }'

Voit välittää enintään kaksi URL-osoitetta input_urls. Kaksi kuvaa luetaan aluksi ja loppuviittaus, joka on tavallinen tapa pitää hahmo tai tuote yhtenäisenä leike. Jos haluat luoda vain tekstiä, ohita latauspuhelu kokonaan.

Pikayhteenveto integraatiosta

Tod Kantaja API avain alkaen /dashboard/ -> API avaimet
Mallin tunnus bytedance/seedance-1.5-pro
Kestoajat 4s, 8s, 12s
Päätökset 480p, 720p, 1080p
Kuvasuhteet 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Tulot Vain Prompt tai prompt ja enintään kaksi kuvan URL-osoitetta
Äänestysvirta Luo työpaikka, kauppa generation_id, sitten kyselyn tila asti completed

Julkinen päätepisteiden yhteenveto

menetelmä Päätepiste Milloin sitä käytetään
POST /seedance/upload/ Lataa ensin kuva, jos haluat ohjata kuvasta videoon
POST /seedance/generate/ Luo Seedance 1.5 Pron sukupolvityö
GET /seedance/status/{generation_id}/ Tarkista, onko työ edelleen käsittelyssä, valmis tai epäonnistunut

Todennus

Kaikki API-pyynnöt vaativat verkkotunnuksen:

Authorization: Bearer YOUR_API_KEY

Hanki API-avain kojelaudan alta API avaimet. Jos tarvitset vielä krediittejä, mene osoitteeseen paketteja ensin.

POST /seedance/upload/

Lataa syötekuvat kuvasta videoon -opastusta varten

Lataa opaskuva ennen luomista, jos haluat Seedancen ankkuroimaan sommittelun, hahmojen kehystyksen tai kohtauksen asettamisen. Vastaus antaa sinulle pysyvän URL-osoitteen, johon voit siirtyä input_urls.

Pyynnön otsikot

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

Lomaketietojen parametrit

tiedosto * (tiedosto)

JPG, PNG tai WebP, enintään 10 Mt.

Onnistunut vastaus (200)

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

Käyttöesimerkki (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/

Luo Seedance 1.5 Pron sukupolvitehtävä

Lähetä joko alla oleva yksinkertaistettu hyötykuorma tai selkeä model plus input muodossa. Käytä yksinkertaistettua versiota, jos tarvitset vain julkisen Seedance-reitin, jossa on prompt, valinnaiset opaskuvat ja lähtöasetukset.

Pyynnön teksti (yksinkertainen)

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

Pyynnön runko (malli/syöttötyyli)

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

Parametrit

prompt * (merkkijono)

3–2500 merkkiä, jotka kuvaavat kohtausta, liikettä, kehystystä ja äänen tarkoitusta.

input_urls (joukko)

Valinnainen. Enintään 2 kuvan URL-osoitetta kuvista videoon -opastusta varten.

aspect_ratio (merkkijono)

Yksi seuraavista: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.

resoluutio (merkkijono)

Yksi seuraavista: 480p, 720p, 1080p.

kesto (merkkijono)

4, 8 tai 12 sekuntia.

fixed_lens (looginen)

Ota käyttöön vakaamman kameranäkymän saamiseksi.

generate_audio (looginen)

Ota käyttöön synkronoitu äänen luominen. Tämä lisää luottojen käyttöä.

prompt_directory_optin (looginen)

Valinnainen. Jaa tukikelpoiset prompt:t prompt-hakemistoon ja käytä alennusta tuettaessa.

Onnistunut vastaus (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}/

Kyselytehtävän tila

Kysely tästä päätepisteestä, kunnes työ lähtee processing. Menestyksestä saat videon URL-osoitteen takaisin; epäonnistumisen yhteydessä sinun tulee tarkistaa virhe ja yrittää uudelleen korjatulla hyötykuormalla.

Käsitellään vastausta

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

Onnistunut vastaus (200)

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

Esimerkkejä koodista: cURL, Python ja JavaScript

Täysi kulku on lähetä → tallenna generation_id → kyselyn tila. Tässä on generointikutsu kolmessa yleisessä pinossa; vaihda oma avaimesi ja 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 (pyynnöt)

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

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

Käyttövirta

  1. Lataa yksi tai kaksi opaskuvaa /seedance/upload/ vain, jos tarvitset kuvasta videoon -opastusta.
  2. Soita /seedance/generate/ prompt, lähtöasetukset ja valinnainen input_urls.
  3. Säilytä palautetut generation_id.
  4. Poll /seedance/status/{generation_id}/ asti status tulee completed.
  5. Käytä palautettua video_url ladata, upottaa tai siirtää lopullinen sisältö omaan työnkulkuusi.

Virhekoodit

400 Virheelliset pyyntöparametrit

401 Todennus epäonnistui (avain puuttuu tai virheellinen API)

402 Riittämättömät luottotiedot

429 Hintaraja ylitetty

500 Sisäinen palvelinvirhe

Hinta- ja hintarajat

UlazAI:n seedance-laskutus perustuu hyvityksiin, joten kustannukset skaalautuvat resoluution ja keston mukaan kiinteän sekuntihinnan sijaan. Käytä tätä suunnitteluoppaana; live-luoton hinta näkyy paketteja ja pyydettäessä.

LähtöTyypillinen käyttöKustannustekijä
480pLuonnokset ja nopeat iteraatiotAlhaisimmat krediitit sekunnissa
720pSosiaaliset videotKeskipisteet sekunnissa
1080pLopullinen toimitusKorkeimmat pisteet sekunnissa; pidemmät kestoajat maksavat enemmän

Hintarajoitukset ja 429 käsittely: jos lähetät useita töitä samanaikaisesti, saatat saada 429 Rate limit exceeded. Käsittele API:tä työperusteisena: lähetä, säilytä generation_id, ja kysely /seedance/status/{generation_id}/ 5-10 sekunnin välein vasaroinnin sijaan. On a 429, peruuta eksponentiaalisesti (esimerkiksi 2s, 4s, 8s) ennen kuin yrität uudelleen.

Seedance 1.5 pro vs Seedance 2.0: tämä viite kattaa bytedance/seedance-1.5-pro, tällä hetkellä Video Studioon kytketty malli. ByteDance on sittemmin esitellyt Seedance 2.0:n seuraavan sukupolvena; kun se on otettu käyttöön tässä, se käyttää samaa generointi- ja kyselyvirtaa ja samaa todennusta, joten integrointikoodi ei muutu – vain mallitunniste muuttuu.

Usein kysytyt kysymykset

Tukeeko UlazAI Seedance API Seedance 2.0:ta ja 2.5:tä?

API tuottaa kanssa bytedance/seedance-1.5-pro tänään. ByteDance julkaisi Seedance 2.0:n helmikuussa 2026 ja on sen jälkeen näyttänyt 2.5:n. Kun uudempi versio on otettu käyttöön tässä, se käyttää samaa verkkotodennusta ja samoja generointi- ja kyselypäätepisteitä, joten integrointikoodisi ei muutu – vain mallin tunniste muuttuu.

Miten UlazAI liittyy ByteDancen viralliseen Seedanceen / ARK API:ään?

Seedance on ByteDancen oma malli, jota tarjotaan ByteDancen Volcano Engine ARK -alustan kautta. UlazAI on kolmannen osapuolen API-taso, joka ajaa Seedancea yhden yksinkertaistetun reitin takana yhdellä Bearer-avaimella, isännöityjen kuvien latauksella ja jaetulla luottolompakolla – ei ARK-tiliä tai raakoja mallipäätepisteitä hallittavaksi.

Kuinka lataan kuvan Seedance-kuvasta videoon?

Lähetä kuva moniosaisena/lomaketietona osoitteeseen POST /seedance/upload/ Bearer-avaimellasi. Vastaus palauttaa pysyvän URL-osoitteen; välitä se (korkeintaan kaksi) sisään input_urls joukko päällä POST /seedance/generate/. Vain tekstiä sisältävät prompt:t ohittavat latausvaiheen.

Kuinka paljon Seedance API maksaa?

Laskutus tapahtuu hyvityksellä, joten kustannukset skaalautuvat resoluution ja keston mukaan. Lyhyt 480p luonnos maksaa vähiten krediittejä; 12 sekunnin 1080p-renderöinti äänen kanssa maksaa eniten. Tarkka hinta näkyy paketteja ja taas kuin credits_used vastauksen luomisessa.

Onko Seedance saatavilla maailmanlaajuisesti API:n kautta?

Kyllä. Soitat UlazAI:n isännöimiin HTTPS-päätepisteisiin siirtotieavaimella, joten VPN:ää, alueellista kiertotapaa tai kiinalaista puhelinnumeroa ei tarvita. Mikä tahansa palvelin, joka voi tehdä autentikoidun HTTPS-pyynnön, voi lähettää töitä ja kyselyn tuloksista.

Minne seuraavaksi

Osta krediittejä Seedance 1.5 Pro -lasku Seedance 2 hinnoittelu Video API asiakirjat API viiteindeksi Avaa Seedance Video Studiossa