ByteDance: Seedance 1.0 Pro
Seedance 1.0 Pro luo äänetöntä videota tekstistä tai aloituskuvasta. Kuvaa toiminta ja kamera tai animoi olemassa oleva sommittelu. Kesto on 2–12 sekuntia, kuvataajuus 24 fps, ja tuloksen rajaus ja tarkkuus voidaan määrittää erikseen.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Seedance 1.0 Pro luo videon tekstistä tai kuvan ohjaamasta kohtauksesta. Valitsin doubao-seedance-1-0-pro-250528 tukee molempia syötetiloja, joten lähtökohtana voi olla kirjallinen konsepti tai olemassa oleva visuaalinen sommittelu. Luo uusi kohtaus tekstiohjeella tai anna kuva, kun kohde, järjestely ja aloitusnäkymä tulee määrittää visuaalisesti. Tämä 1.0-profiili tuottaa äänetöntä videota; synkronoitu ääni kuuluu erikseen kuvattuun 1.5 Pro -profiiliin.
Määritä tekstistä videoksi -tehtävässä kohde, ympäristö, liike, rajaus ja kamera yhdeksi johdonmukaiseksi kohtaukseksi. Dokumentoitu esimerkki siirtyy vähitellen päivänkakkaraniityltä lähikuvaan kukasta, jonka terälehdillä on kastetta. Rakenne sopii muihinkin paljastuksiin: esittele ympäristö, liiku kohti kohdetta ja päätä olennaiseen yksityiskohtaan. Kuvaa tuotekonseptissa materiaali ja valaistus toiminnan lisäksi ja anna kameralle lyhyeen otokseen toteutuskelpoinen reitti.
Aseta kuvasta videoksi -tehtävässä viite image_url-tyyppiseen content-kohteeseen ja selitä, minkä tulee muuttua tästä aloitusnäkymästä. Valmisteltu muotokuva voi määrittää henkilön ja rajauksen, kun ohje kuvaa pientä käännöstä, liikkuvia hiuksia tai kameran lempeää loittonemista. Tuotekuva voi määrittää esineen ja taustan, kun kehote pyytää hallittua paljastusta. Pidä pyydetty liike lähdesommitteluun sopivana; kuva esineen yhdestä puolesta ei tarjoa tarkkaa kuvaa kaikista muista puolista, joita lähdekuvassa ei näy.
Kuvakenttä hyväksyy saatavilla olevan URL-osoitteen tai data-URL:n, joka sisältää Base64-kuvadataa. Dokumentoidut muodot ovat JPEG, PNG, WEBP, BMP, TIFF ja GIF. Kuvan koon tulee olla alle 30 MB, leveyden ja korkeuden suhteen yli 0.4 ja alle 2.5 ja kummankin ulottuvuuden yli 300 ja alle 6000 pikseliä. Valmistele selkeä lähde halutulla rajauksella sen sijaan, että luottaisit pikkukuvaan, josta määrittävät yksityiskohdat jo puuttuvat. Kuvasta videoksi -luontiin ohje suosittelee mukautuvaa rajausta viitteen mittasuhteiden seuraamiseksi.
Dokumentoitu 1.0-kesto on kahdesta kahteentoista sekuntiin ja kuvataajuus 24 fps. Tulosasetuksissa ovat tasot 480p, 720p ja 1080p, joista 1080p on Pron oletus; ohje sulkee 1080p:n pois viitekuvaa käytettäessä. Kiinteät kuvasuhteet ovat 16:9, 4:3, 1:1, 3:4, 9:16 ja 21:9. Valitse kuvan kanssa yhteensopiva yhdistelmä kuvapohjaiseen otokseen sen sijaan, että siirtäisit kaikki tekstistä videoksi -asetukset muuttamattomina. Tarkista todella palautettu rajaus ennen leikkeen sijoittamista asetteluun.
seed- ja watermark-asetukset on dokumentoitu camerafixed-asetuksen rinnalla. Kiinteän kameran ohjetta ei tueta viitekuvaa käytettäessä, eikä ohje takaa täysin paikallaan pysyvää kameraa niissäkään tilanteissa, joihin asetus soveltuu. Kehotteeseen sisällytetyt parametriohjeet ovat ensisijaisia erillisiin valinnaisiin kenttiin nähden. Pidä kestolle, tarkkuudelle ja kuvasuhteelle yksi ensisijainen asetus ja sovita kamerakuvaus siihen. Näin kohtausohje ei huomaamatta ohita pyynnölle valittuja asetuksia.
Käyttö mitataan videotokeneina: tuloksen leveys × tuloksen korkeus × kuvataajuus × tuloksen kesto / 1024. Valmis tehtävä ilmoittaa määrän kentässä usage.completion_tokens. Säilytä ilmoitettu käyttö valmiin leikkeen ja sen pyydettyjen asetusten mukana.
Työnkulku palauttaa ensin tehtävätunnisteen ja käsittelyn jälkeen valmiin videon sijainnin. Säilytä tunniste jonossa olevan tai käynnissä olevan tehtävän tilaa tarkistaessasi; onnistunut tehtävä antaa kentän content.video_url ja käyttötiedot. Luotujen tiedostojen dokumentoitu säilytysaika on seitsemän päivää. Tallenna valmis leike, lähdekuva ja täsmällinen kehote muokkaustietueeksi ja tarkista sitten kohteen ulkoasu, liike, kuvan jatkuvuus ja loppusommittelu koko tuloksesta.
Ailoot Ultra · Videot POST /v1/videos doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528Aloitus
Seedance 1.0 Pro luo äänetöntä videota tekstistä tai aloituskuvasta. Kuvaa toiminta ja kamera tai animoi olemassa oleva sommittelu. Kesto on 2–12 sekuntia, kuvataajuus 24 fps, ja tuloksen rajaus ja tarkkuus voidaan määrittää erikseen.
- Hyväksytyt syötteet
- Teksti · Kuvat
- Tulokset
- Video
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Videot POST /v1/videos
- Syötetyypit
text,image- Tulostyypit
video
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat doubao-seedance-1-0-pro-250528 | Oletus— |
Kenttäcontent | Tyyppiarray | VaatimusPakollinen | Arvot & rajat Ehdot: Natiivit teksti- ja mediaoliot; ulompi taulukko ei saa olla tyhjä. Tämä Ailoot-palvelun yleinen pyyntörakentaja ei validoi sisäkkäisten solmujen tyyppejä. | Oletus— |
Kenttäduration | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 2 Enimmäismäärä: 12 Ehdot: Ensisijainen 1.x-skeema: 2–12; myöhempi yhteinen kuvaus määrittää versiolle 1.5 arvot 4–12 tai -1. Esimerkki käyttää molemmissa dokumentoitua arvoa 5. | Oletus5 |
Kenttäresolution | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Vahvistetut tekstistä videoksi -arvot ovat 480p ja 1080p. Viitekuvasyöte sulkee pois resoluution 1080p. Yhteinen 720p-enum on ristiriidassa mallikohtaisen tekstin kanssa, joten 720p-tuki on ratkaisematta molemmissa tiloissa. | Oletus1080p |
Kenttäratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Ehdot: Kohtaus- tai mallikohtaiset oletusarvot; kuvasyötteen dokumentaatio suosittelee adaptive-arvoa. | Oletus— |
Kenttäservice_tier | Tyyppistring | VaatimusValinnainen | Arvot & rajat default, flex Ehdot: default=online, flex=offline; valitse ennen luontia. | Oletusdefault |
Kenttäseed | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat Vähimmäismäärä: −1 Enimmäismäärä: 4 294 967 295 | Oletus−1 |
Kenttäcamerafixed | Tyyppiboolean | VaatimusPakollinen | Arvot & rajat Ehdot: Ailoot edellyttää tätä; viitekuvan kameraohjaus on dokumentoitu tukemattomaksi, eikä sen vaikutusta taata. | Oletusfalse |
Kenttäwatermark | Tyyppiboolean | VaatimusPakollinen | Arvot & rajat | Oletusfalse |
Kenttäexecution_expires_after | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat Vähimmäismäärä: 3 600 Enimmäismäärä: 259 200 Yksikkö: sekuntia | Oletus172 800 |
Syöteaineistojen yhdistelmät
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimuscamerafixed, content, execution_expires_after, model, seed, watermark |
Parametrioptional | Sopimusduration, resolution, ratio, service_tier |
Parametrimaterial_types | Sopimustext, image |
Parametriadditional_properties | Sopimustrue |
Parametrivalidation_scope | SopimusAiloot tarkistaa pakollisten kenttien tyypit ja sen, että model/content-taulukko ei ole tyhjä. Muut pyyntökentät säilytetään valittua mallia varten. |
Parametriimage_constraints | Sopimus{"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} |
Menetelmien aliakset: /v1/videos/generations
Elinkaari: 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
Luo kerran ja säilytä palautettu julkinen id/polling_url.
Kysy alkuperäisen työn tilaa; lataa todellinen käyttäjälle kuuluva content.video_url-sisältö succeeded-tilan jälkeen.
Hinnoittelu
Lopullisen veloituksen laskenta
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Arvioidut vertailuhinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Laskutusyksikkö | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusyksikkö— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetUltra | Hinnasto— | Ennustettu määrä— | Laskutusyksikkö1K videotokenia kohden | Veloitus Tuloste · Arvio vain vertailua varten $0.0044 1K videotokenia kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.2112 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
Ailoot Ultra · Videot
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
Vastaanota ja tallenna tulokset
Ailoot Ultra · Videot
Natiivi JSON, jossa on julkinen id/polling_url. Julkaisun jälkeen content.video_url sisältää Ailoot-palvelun hallinnoimat allekirjoitetut URL-osoitteet; ennen julkaisua valitut tulosten URL-osoitteet tyhjennetään.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.
Säilytä jokainen todellinen URL content.video_url-kentässä; index-arvon on yksilöitävä todellinen palautettu tulos.
Jos alkuperäinen vastaus on tarkistettava
Säilytä alkuperäinen vastaus, otsakkeet ja id sekä kysy saman operaation tilaa; älä koskaan lähetä tuntemattomaan tilaan jäänyttä luontipyyntöä uudelleen.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttäprovider_task_id | Tyyppistring |
Kenttäpolling_url | Tyyppistring |
Kenttästatus | Tyyppistring when supplied |
Kenttäcontent.video_url | Tyyppistring|string[] |
Kenttäusage | Tyyppiobject when supplied |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheellinen JSON/model, pakollisten kenttien tyypit tai sisältöindeksi. | Seuraava vaihe |
Vastaus401 · authentication_error | EhtoVirheellinen Ailoot API -avain. | Seuraava vaihe |
Vastaus404 · not_found_error | EhtoTehtävä tai tulos puuttuu tai ei kuulu samalle käyttäjälle/API-avaimelle/ryhmälle. | Seuraava vaihe |
Vastaus502 · result_pending_check | EhtoAlkuperäinen lähetys tai tilatieto on puutteellinen; säilytä alkuperäinen tunniste, älä lähetä uudelleen. | Seuraava vaihe |
Vastaus503 · result_pending_check | EhtoAlkuperäistä mediaa, reittiä tai veloituksen lopullista kirjausta tarkistetaan; jatka alkuperäistä operaatiota. | Seuraava vaihe |
Aliakset
Mallin aliakset
Ailoot Ultra doubao-seedance-1-0-pro-250528
Menetelmäpolkujen aliakset
/v1/videos/generations
Liittyvät kutsujan ID:t
FAQ · ByteDance: Seedance 1.0 Pro
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·doubao-seedance-1-0-pro-250528:text,image→video- Mitä kenttiä pyyntö käyttää?
POST /v1/videos·doubao-seedance-1-0-pro-250528:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Mitä rajoja sovelletaan?
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