ByteDance: Seedance 1.5 Pro
Seedance 1.5 Pro ustvari video iz besedila ali slike ter lahko ustvari sinhronizirane glasove, učinke in glasbo v ozadju. Zvok lahko vklopite ali izklopite; dokumentirani profil ponuja prizore v trajanju 4–12 sekund, prilagodljiv format ter obdelavo online ali flex.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Seedance 1.5 Pro ustvari video iz besedila ali slike in lahko ustvari zvok skupaj s sliko. Konkretni identifikator je doubao-seedance-1-5-pro-251215. Nastavitev zvoka ga razlikuje od profilov Seedance 1.0 brez zvoka: generate_audio=true zahteva sinhronizirani zvok, false pa video brez zvoka. Za novo zamisel uporabite pisni opis prizora ali s sliko določite začetni glavni motiv in kompozicijo.
Vizualno dejanje in zvok opišite kot dela istega prizora. Določite glavni motiv, okolje, gibanje in kamero, nato pojasnite predvidene glasove, zvočne učinke ali glasbo v ozadju. Portretni prizor lahko prikaže osebo, ki odpira oči, medtem ko se kamera počasi oddaljuje, v okolju pa se sliši veter. Pri produktnem prizoru povežite zvok z vidnim dogodkom, na primer z odpiranjem pokrova ali dotikom predmeta s površino, namesto da dodajate nepovezan seznam učinkov.
Model lahko iz poziva in vizualne vsebine ustvari glasove, učinke in glasbo v ozadju. Vodnik priporoča zapis govorjenih dialogov v dvojnih narekovajih. Govor naj bo dovolj kratek za zahtevano dejanje in premore; kadar nastopa več likov, jasno določite, kdo govori. Preverite dejansko besedilo, pripis glasov in sinhronizacijo s sliko. Zvočno navodilo usmerja ustvarjeno izvedbo; v dokumentirani zahtevi tega profila ni ločen, naložen vhod z glasovno referenco.
Ustvarjanje videa iz slike uporablja postavko image_url skupaj z besedilom. Podajte dostopen URL slike ali podatkovni URL Base64 v formatu JPEG, PNG, WEBP, BMP, TIFF ali GIF. Dokumentirane omejitve slike so manj kot 30 MB, obe meri strogo med 300 in 6000 slikovnimi pikami ter razmerje med širino in višino strogo med 0.4 in 2.5. Jasno pripravite predvideni izrez in glavni motiv, nato opišite gibanje iz te kompozicije. Primer s sliko uporablja prilagodljivo razmerje stranic, ki sledi referenci.
Vodnik za trajanje tega profila navaja cele sekunde od štirih do dvanajstih ali -1, pri katerem model izbere trajanje v tem razponu. Privzeto trajanje je pet sekund. Seedance 1.5 Pro ima privzeto ločljivost 720p, ohranjena tabela profila pa navaja 480p in 720p; namenski operativni vodnik ne ponuja 1080p za 1.5 Pro. Fiksne izbire razmerja vključujejo 16:9, 4:3, 1:1, 3:4, 9:16 in 21:9, dokumentirana privzeta vrednost za 1.5 pa je adaptive. Preverite dejansko trajanje in razmerja posnetka, namesto da zahtevane vrednosti obravnavate kot že vrnjen rezultat.
Zahteva omogoča dve ravni obdelave. service_tier=default izbere obdelavo online, flex pa obdelavo offline za delo, ki dopušča daljši zamik. Po oddaji naloge ravni ni mogoče spremeniti. Izberite jo glede na časovne potrebe postopka in izbiro shranite v zapis zahteve. Način zvoka in raven obdelave sta ločeni izbiri: posnetek brez zvoka ni samodejno naloga offline, vklop zvoka pa ne izbere ravni obdelave.
Navodila za seed, watermark in kamero naj bodo skladna s prizorom. Ukazi za parametre, vključeni v besedilo, imajo prednost pred ločenimi neobveznimi parametri. Nastavitev fiksne kamere je pri uporabi referenčne slike izključena in tam, kjer se uporablja, ne zagotavlja nepremične slike. Pri animaciji, vodeni s sliko, želeno gibanje pojasnite neposredno, namesto da predpostavljate, da nastavitev kamere odpravi potrebo po opisu kadra.
Poraba se meri v videožetonih: širina izhoda × višina izhoda × hitrost sličic × trajanje izhoda / 1024. Dokončana naloga to količino sporoči kot usage.completion_tokens. Sporočeno porabo shranite skupaj s končanim posnetkom in zahtevanimi nastavitvami. Vklopljen ali izklopljen zvok ter obdelava online ali flex pri obračunavanju po porabi ostajajo ločene kategorije.
Oddaja vrne identifikator asinhrone naloge. Nalogo spremljajte do dokončanja, nato shranite video, podan v content.video_url. Dokumentirano obdobje hrambe ustvarjene datoteke je sedem dni. Veljavnost se meri od nastanka, privzeta vrednost je 172800 sekund, sprejema pa vrednosti od 3600 do 259200 sekund; nedokončana naloga po nastavljenem intervalu preide v stanje s pretečeno veljavnostjo. Končni posnetek, izvorno sliko in natančna vizualna ter zvočna navodila hranite skupaj, nato v celotnem rezultatu preverite dejanje, identiteto, kontinuiteto gibanja kamere in usklajenost zvoka.
Ailoot Ultra · Videoposnetki POST /v1/videos doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215Začetek
Seedance 1.5 Pro ustvari video iz besedila ali slike ter lahko ustvari sinhronizirane glasove, učinke in glasbo v ozadju. Zvok lahko vklopite ali izklopite; dokumentirani profil ponuja prizore v trajanju 4–12 sekund, prilagodljiv format ter obdelavo online ali flex.
- Dovoljeni vhodi
- Besedilo · Slike
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Videoposnetki POST /v1/videos
- Vhod
text,image- Izhod
video
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve doubao-seedance-1-5-pro-251215 | Privzeto— |
Poljecontent | Vrstaarray | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Izvorni besedilni/medijski objekti; zunanje polje mora biti neprazno. Ta splošni konstruktor Ailoot ne preverja vrst ugnezdenih vozlišč. | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Primarna shema 1.x določa 2–12; poznejši skupni opis za 1.5 navaja 4–12 ali -1. Primer uporablja v obeh virih dokumentirano vrednost 5. | Privzeto5 |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480p, 720p Pogoji: Seedance 1.5 Pro podpira 480p in 720p; 1080p je izključen. Dokumentirana privzeta ločljivost je 720p. | Privzeto720p |
Poljeratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Pogoji: Dokumentirano privzeto razmerje za Seedance 1.5 Pro je adaptive. Možnosti fiksnega razmerja ostajajo nespremenjene. | Privzetoadaptive |
Poljeservice_tier | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve default, flex Pogoji: default=online, flex=offline; izberite pred ustvarjanjem. | Privzetodefault |
Poljeseed | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve Najmanj: −1 Največ: 4.294.967.295 | Privzeto−1 |
Poljecamerafixed | Vrstaboolean | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Ailoot zahteva to polje; upravljanje kamere z referenčno sliko je dokumentirano kot nepodprto, njegov učinek pa ni zagotovljen. | Privzetofalse |
Poljewatermark | Vrstaboolean | ZahtevaObvezno | Vrednosti in omejitve | Privzetofalse |
Poljeexecution_expires_after | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve Najmanj: 3600 Največ: 259.200 Enota: sekunde | Privzeto172.800 |
Poljegenerate_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Sinhroniziran zvok, vdelan v ustvarjeni video, samo za 1.5. | Privzetotrue |
Kombinacije vhodnih gradiv
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijacamerafixed, content, execution_expires_after, model, seed, watermark |
Parameteroptional | Specifikacijaduration, resolution, ratio, service_tier, generate_audio |
Parametermaterial_types | Specifikacijatext, image |
Parameteradditional_properties | Specifikacijatrue |
Parametervalidation_scope | SpecifikacijaAiloot preveri obvezne vrste polj in neprazno polje model/content. Druga polja zahteve se ohranijo za izbrani model. |
Parameterimage_constraints | Specifikacija{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Druga imena metode: /v1/videos/generations
Življenjski cikel: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Ustvarite enkrat in ohranite vrnjeni javni id/polling_url.
Preverjajte prvotno opravilo; po succeeded prenesite dejansko vsebino content.video_url v vaši lasti.
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Ustvari zvok | Razred storitve | Obračunska enota | Strošek |
|---|---|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Ustvari zvok— | Razred storitve— | Obračunska enota— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevRaven storitve: obdelava offline (flex). Izhod s sinhroniziranim zvokom. | Cenovna lestvica— | Predvidena količina— | Ustvari zvokZ zvokom | Razred storitveflex | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.0024 na 1K video žetonov |
| NastavitevRaven storitve: obdelava offline (flex). Izhod brez sinhroniziranega zvoka. | Cenovna lestvica— | Predvidena količina— | Ustvari zvokBrez zvoka | Razred storitveflex | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.0012 na 1K video žetonov |
| NastavitevRaven storitve: obdelava online (default). Izhod s sinhroniziranim zvokom. | Cenovna lestvica— | Predvidena količina— | Ustvari zvokZ zvokom | Razred storitvedefault | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.0048 na 1K video žetonov |
| NastavitevRaven storitve: obdelava online (default). Izhod brez sinhroniziranega zvoka. | Cenovna lestvica— | Predvidena količina— | Ustvari zvokBrez zvoka | Razred storitvedefault | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.0024 na 1K video žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Ustvari zvok— | Razred storitve— | Obračunska enota— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.1152 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot Ultra · Videoposnetki
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Prejmi in shrani rezultate
Ailoot Ultra · Videoposnetki
Izvorni JSON z javnima id/polling_url. Po objavi content.video_url vsebuje podpisane URL-je v lasti Ailoot; pred objavo so izbrani izhodni URL-ji izpraznjeni.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak dejanski URL v content.video_url; index mora označevati dejanski vrnjeni izhod.
Če je treba preveriti izvirni odgovor
Ohranite prvotni odgovor/glave/id in preverjajte to operacijo; neznanega ustvarjanja nikoli ne oddajte znova.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljeprovider_task_id | Vrstastring |
Poljepolling_url | Vrstastring |
Poljestatus | Vrstastring when supplied |
Poljecontent.video_url | Vrstastring|string[] |
Poljeusage | Vrstaobject when supplied |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljaven JSON/model/vrste obveznih polj ali indeks vsebine. | Naslednji korak |
Odgovor401 · authentication_error | PogojNeveljaven ključ Ailoot API. | Naslednji korak |
Odgovor404 · not_found_error | PogojOpravilo/izhod manjka ali ni v lasti istega uporabnika/ključa API/skupine. | Naslednji korak |
Odgovor502 · result_pending_check | PogojPrvotna oddaja/stanje je nepopolno; ohranite prvotni ID, ne oddajte znova. | Naslednji korak |
Odgovor503 · result_pending_check | PogojPrvotni medij/pot/obračun se preverja; nadaljujte prvotno operacijo. | Naslednji korak |
Druga imena
Druga imena modelov
Ailoot Ultra doubao-seedance-1-5-pro-251215
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · ByteDance: Seedance 1.5 Pro
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·doubao-seedance-1-5-pro-251215:text,image→video- Katera polja uporablja zahteva?
POST /v1/videos·doubao-seedance-1-5-pro-251215:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after,generate_audio- Katere omejitve veljajo?
POST /v1/videos·doubao-seedance-1-5-pro-251215:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200