ByteDance: Seedance 1.0 Pro
Seedance 1.0 Pro ustvari video brez zvoka iz besedila ali začetne slike. Opišite dejanje in kamero ali oživite obstoječo kompozicijo s trajanjem 2–12 sekund, 24 fps ter izrecnimi nastavitvami formata in ločljivosti izhoda.
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 ustvari video iz besedila ali prizora, vodenega s sliko. Identifikator doubao-seedance-1-0-pro-250528 podpira oba vhodna načina, zato je lahko izhodišče pisna zamisel ali obstoječa vizualna kompozicija. Besedilno navodilo uporabite za nov prizor, sliko pa priložite, kadar želite glavni motiv, razporeditev in začetni pogled določiti vizualno. Ta profil 1.0 ustvarja video brez zvoka; sinhronizirani zvok pripada ločeno opisanemu profilu 1.5 Pro.
Pri ustvarjanju videa iz besedila določite glavni motiv, okolje, gibanje, kompozicijo in kamero v enem skladnem prizoru. Dokumentirani primer postopno preide s polja marjetic na bližnji pogled cveta z roso na cvetnih listih. Ta zgradba je uporabna tudi za druga postopna razkritja: predstavite okolje, približajte se glavnemu motivu in končajte pri pomembni podrobnosti. Pri produktni zamisli poleg dejanja opišite material in osvetlitev ter kameri določite izvedljivo pot skozi kratek kader.
Pri ustvarjanju videa iz slike referenco vključite kot vsebinsko postavko image_url in pojasnite, kaj naj se od začetnega pogleda spremeni. Pripravljen portret lahko določi osebo in izrez, navodilo pa opiše majhen zasuk, premikanje las ali nežno oddaljevanje kamere. Fotografija izdelka lahko določi predmet in ozadje, poziv pa zahteva nadzorovano razkritje. Zahtevano gibanje naj bo združljivo z izvorno kompozicijo; slika ene strani predmeta ne poda natančnega, še nevidenega pogleda na vse druge strani.
Polje za sliko sprejme dostopen URL ali podatkovni URL s slikovnimi podatki Base64. Dokumentirani formati so JPEG, PNG, WEBP, BMP, TIFF in GIF. Slike morajo biti manjše od 30 MB, razmerje med širino in višino mora biti strogo med 0.4 in 2.5, vsaka mera pa strogo med 300 in 6000 slikovnimi pikami. Pripravite jasen vir v predvidenem izrezu, namesto da se zanašate na sličico, v kateri ključne podrobnosti že manjkajo. Pri ustvarjanju videa iz slike vodnik priporoča prilagodljiv format, ki sledi razmerjem reference.
Dokumentirano trajanje za 1.0 je od dveh do dvanajstih sekund, hitrost sličic pa 24 fps. Nastavitve izhoda vključujejo ravni 480p, 720p in 1080p, pri čemer je privzeta vrednost Pro 1080p; vodnik izključuje 1080p pri uporabi referenčne slike. Fiksni formati vključujejo 16:9, 4:3, 1:1, 3:4, 9:16 in 21:9. Za kader, ki izhaja iz slike, izberite s sliko združljivo kombinacijo, namesto da nespremenjeno prenesete vse nastavitve za ustvarjanje iz besedila. Preden posnetek vključite v postavitev, preverite dejansko vrnjeno kompozicijo.
Nastavitvi seed in watermark sta dokumentirani skupaj s camerafixed. Navodilo za fiksno kamero pri uporabi referenčne slike ni podprto; kjer se uporablja, vodnik ne zagotavlja popolnoma nepremične kamere. Navodila za parametre, vključena v poziv, imajo prednost pred ločenimi neobveznimi polji. Za trajanje, ločljivost in razmerje določite eno veljavno nastavitev ter z njo uskladite opis kamere. Tako navodilo za prizor ne bo neopazno preglasilo nastavitev, izbranih za zahtevo.
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.
Postopek najprej vrne identifikator naloge, po obdelavi pa mesto dokončanega videa. Identifikator ohranite med preverjanjem čakanja v vrsti ali izvajanja; uspešno dokončana naloga poda content.video_url in podatke o porabi. Dokumentirano obdobje hrambe ustvarjene datoteke je sedem dni. Končani posnetek, izvorno sliko in natančen poziv shranite kot zapis različice, nato v celotnem rezultatu preverite videz glavnega motiva, gibanje, kontinuiteto s sliko in končno kompozicijo.
Ailoot Ultra · Videoposnetki POST /v1/videos doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528Začetek
Seedance 1.0 Pro ustvari video brez zvoka iz besedila ali začetne slike. Opišite dejanje in kamero ali oživite obstoječo kompozicijo s trajanjem 2–12 sekund, 24 fps ter izrecnimi nastavitvami formata in ločljivosti izhoda.
- 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-250528 | 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.0044 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.2112 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-250528","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-250528
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · ByteDance: Seedance 1.0 Pro
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·doubao-seedance-1-0-pro-250528:text,image→video- Katera polja uporablja zahteva?
POST /v1/videos·doubao-seedance-1-0-pro-250528:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Katere omejitve veljajo?
POST /v1/videos·doubao-seedance-1-0-pro-250528:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200