ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast je ločeno poimenovan profil Fast za ustvarjanje videa brez zvoka iz besedila ali slike. Sprejme opis prizora ali kompozicijo, vodeno s sliko, z izhodom v trajanju 2–12 sekund, 24 fps in izrecnimi nastavitvami formata.
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.0 Pro Fast je profil Fast z identifikatorjem doubao-seedance-1-0-pro-fast-251015. Ustvarja video brez zvoka iz pisnega opisa prizora ali začetne kompozicije, vodene s sliko. Konkretni identifikator ta profil razlikuje od Seedance 1.0 Pro; beseda Fast ne določa zagotovljenega časa dokončanja posamezne naloge. Vhodni način izberite glede na to, kaj naj določi prizor, nato vrnjeni posnetek ocenite glede na navodilo.
Kader, voden z besedilom, se začne s strnjenim zaporedjem: glavni motiv in okolje, dejanje, pot kamere in končni pogled. Pri razkritju izdelka opišite predmet na podlagi, svetlobo na njegovem materialu in kratek premik, ki se konča na predstavljeni značilnosti. Pri zamisli za lokacijo preidite s širokega uvodnega pogleda k prepoznavni osrednji točki. Od enega kratkega posnetka ne zahtevajte več nepovezanih prizorov, pri katerih je treba vse glavne motive in okolja predstaviti od začetka.
Kader, voden s sliko, se začne s postavko image_url v polju content in besedilnim navodilom za gibanje. V sliki pripravite izrez, ozadje in razporeditev glavnih motivov, nato določite, kateri elementi se premikajo in kako se vede kamera. Tako lahko statična kompozicija postane kratek animiran prizor. To je uporabno za portret, predmet na mizi ali pripravljen vizualni koncept, dejanski rezultat pa je še vedno treba v celotnem posnetku preveriti glede identitete, oblike in gibanja.
Slikovni vhodi lahko uporabijo dostopen URL ali podatkovni URL Base64. Dokumentirani formati so JPEG, PNG, WEBP, BMP, TIFF in GIF; slika mora biti manjša od 30 MB, obe meri strogo med 300 in 6000 slikovnimi pikami, količnik širine in višine pa strogo med 0.4 in 2.5. Izberite čist vir z vidnimi podrobnostmi glavnega motiva. Vodnik za slike priporoča prilagodljiv format, zato naj razmerja pripravljenega vira ustrezajo kompoziciji, ki jo želite oživiti.
Profil 1.0 ima dokumentirano trajanje od dveh do dvanajstih sekund pri 24 fps. Privzeta ločljivost Pro Fast je 1080p, ohranjena tabela izhodov pa navaja ravni 480p, 720p in 1080p. Operativni vodnik izključuje 1080p pri uporabi referenčne slike. Fiksna razmerja stranic vključujejo 16:9, 4:3, 1:1, 3:4, 9:16 in 21:9. Izberite ločljivost in format, primerna za izbrani vhodni način, namesto da predpostavljate, da so vse kombinacije zamenljive.
Možnosti seed in watermark pomagata izrecno določiti nastavitve zahteve. Razpon celoštevilčne vrednosti seed je od -1 do 2^32-1; -1 zahteva naključno izbiro. Navodilo za fiksno kamero ima pogoje: vodnik ga izključuje pri uporabi referenčne slike in ne zagotavlja vizualnega učinka tam, kjer je podprt. Ukazi za parametre, vključeni v besedilo, preglasijo ločene neobvezne parametre. Ta navodila naj bodo skladna, zlasti pri spreminjanju poziva, v katerega opisu prizora bi sicer lahko ostal star ukaz za trajanje ali ločljivost.
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.
Oddaja ustvari asinhrono nalogo. Shranite njen identifikator, spremljajte stanje in po uspešnem zaključku pridobite končani video iz content.video_url. Dokumentacija navaja sedemdnevno hrambo ustvarjenih datotek, zato končani rezultat shranite skupaj s pozivom in morebitno vhodno sliko. Preverite celotno dejanje, gibanje kamere in končno kompozicijo; če kakšna podrobnost ne ustreza navodilu, opišite prav ta popravek in ohranite dele, ki so uspeli.
Ailoot Ultra · Videoposnetki POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Začetek
Seedance 1.0 Pro Fast je ločeno poimenovan profil Fast za ustvarjanje videa brez zvoka iz besedila ali slike. Sprejme opis prizora ali kompozicijo, vodeno s sliko, z izhodom v trajanju 2–12 sekund, 24 fps in izrecnimi nastavitvami formata.
- 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-0-pro-fast-251015 | 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 Najmanj: 2 Največ: 12 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 Pogoji: Potrjeni vrednosti za pretvorbo besedila v video sta 480p in 1080p. Vhod z referenčno sliko izključuje 1080p. Skupna vrednost enum 720p je v nasprotju z opisom za določen model, zato podpora za 720p ostaja nerazrešena v obeh načinih. | Privzeto1080p |
Poljeratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Pogoji: Privzete vrednosti so odvisne od prizora/modela; dokumentacija za slikovni vhod priporoča adaptive. | Privzeto— |
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 |
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 |
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 | Obračunska enota | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | 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 |
| NastavitevUltra | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.0012 na 1K video žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.0576 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-0-pro-fast-251015","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
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-0-pro-fast-251015
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Katera polja uporablja zahteva?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Katere omejitve veljajo?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200