ByteDance: Seedance 2.5
Seedance 2.5 luo videoita tekstin sekä kuva-, video- tai ääniviitteiden perusteella ja tarjoaa dokumentoidut työnkulut muokkaamiseen ja jatkamiseen. Sen täsmällisessä 2.5-esimerkissä tuotekuva yhdistetään useisiin liikeviitteisiin ja luotu ääni otetaan käyttöön yhtenäistä mainosjaksoa varten.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Seedance 2.5 luo videoita kirjoitetun kohtauksen ja monimodaalisten viitteiden perusteella. Täsmällisellä valitsimella doubao-seedance-2-5-260628 on oma dokumentoitu toimintonsa ja esimerkkinsä. Toiminto kattaa videoiden luomisen, muokkaamisen ja jatkamisen, ja syötemateriaaleina käytetään kuvia, videoita, ääntä ja tekstiä. Välitä viitteillä kohteen ulkonäkö, toiminta, kameran liike, tyyli ja ääni ja kerro sitten, millainen tulos niiden perusteella pitäisi luoda.
Syöteyhdistelmiin kuuluvat pelkkä teksti, kuvat tai video valinnaisen tekstin kanssa, kuvat ja ääni, video ja ääni sekä kuvat, video ja ääni yhdessä. Luetelluissa yhdistelmissä ääni liittyy visuaaliseen materiaaliin; ne eivät kuvaa pelkän äänen sisältävää pyyntöä. Järjestä kukin aineisto roolinsa mukaan: kuva määrittää kohteen tai ilmeen, video näyttää liikkeen tai olemassa olevan kohtauksen ja ääni toimii ääniviitteenä. Kerro, mikä rooli on pyydetylle otokselle olennainen, jotta taustaviitettä ei tulkita päähenkilöksi.
Täsmällinen 2.5-esimerkki on tuotemainosjakso. Siinä annetaan kuva ja useita videoviitteitä ja kuvataan sitten alun huomion kohde, järjestetyt tuoteasetelmat, yksityiskohtaotokset, hidastettu toiminta ja lopun brändisommitelma. Pyyntö määrittää roolit reference_image ja reference_video ja käyttää yksittäisiä viitteitä sommittelun, liikkeen, kameratyön ja vaikutuksen ohjaamiseen. Näin kampanjaidealle saadaan käytännöllinen rakenne: suunnittele näkyvät vaiheet, nimeä kunkin vaiheen viite ja määritä lopullinen asetelma.
Kirjoitetussa jaksossa voi erottaa tapahtumat niiden kuvaustavasta. Kuvaa ensin tuotteen toiminta ja sitten kuvakoko, kameran reitti, rytmi ja siirtymä seuraavaan näkymään. Jos yksi viite määrittää tuotteen ja toinen näyttää kameran liikkeen, nimeä nämä tehtävät erikseen. Jos kohtauksessa on useita esineitä, selitä niiden sijainnit ja vuorovaikutusten järjestys. Tarkista luodusta tuloksesta tuotteen todellinen muoto, asetelma ja liike sen sijaan, että olettaisit jokaisen viitteen yksityiskohdan säilyvän muuttumattomana.
Muokkauksessa nimeä olemassa oleva video ja muutettava osa, kuten ympäristö, toiminta tai visuaalinen tyyli, ja kerro samalla, mikä jatkuvuus pitää säilyttää. Jatkamisessa kuvaa, miten kohtauksen tulee jatkua annetusta videomateriaalista. Tarkista liitoskohta uuden jakson lisäksi: kohteen ulkonäkö, liikkeen suunta, kameran sijainti ja äänen ajoitus vaikuttavat kaikki siihen, näyttäytyykö tulos yhtenä kohtauksena. Säilytä alkuperäinen video ja valmis muokkaus yhdessä, jotta muutosta voi verrata tavoiteltuun jatkuvuuteen.
Dokumentoidussa monimodaalisessa 2.5-esimerkissä asetetaan generate_audio=true ja pyydetään viidentoista sekunnin jaksoa kuvasuhteella 16:9. Nämä arvot kuvaavat kyseistä esimerkkiä, eivät yleistä keston enimmäisrajaa tai viiteaineiston rajoitusta. Anna pyydetylle kohtaukselle selkeä äänisuunnitelma, joka kertoo myös musiikin, tehosteiden ja näkyvän toiminnan suhteesta, ja arvioi sitten todellinen audiovisuaalinen tulos. Tarkista ääniviite ja luotu ääniraita yhdessä tavoitellun rytmin ja toteutuksen kannalta.
Valitse kesto, kuvasuhde ja resoluutio juuri tämän profiilin tarjoamista asetuksista. Säilytä pyydetty kokoonpano kehotteen kanssa ja vertaa sitä tehtävän todellisiin palautettuihin kenttiin. Käytä palautettua kestoa, resoluutiota ja kuvasuhdetta, kun valmistelet valmista leikettä kohdekäyttöön. Säilytä täsmällinen profiilitunnus muokkausmerkinnässä, jotta myöhemmässä vertailussa käytetään samaa valittua versiota.
Videotokenien käyttö lasketaan kaavalla (syötevideon kesto + tulosvideon kesto) × tuloksen leveys × tuloksen korkeus × tuloksen kuvataajuus / 1024. Syötevideon sisältävillä pyynnöillä ja pyynnöillä ilman syötevideota on erilliset laskutusluokat. Tehtäväkysely ilmoittaa kentät usage.completion_tokens ja usage.total_tokens; säilytä nämä ilmoitetut määrät valmiin leikkeen kanssa.
Luominen on asynkronista. Lähetys palauttaa tunnisteen, ja määritetty tehtäväkulku antaa ensin tilan ja onnistumisen jälkeen kentän content.video_url. Tallenna valmis leike yhdessä lähdemateriaalin ja jakson suunnitelman kanssa. Tarkista kaikki suunnitellut vaiheet, esineiden vuorovaikutukset, hahmojen ulkonäkö, rajaus sekä äänen ja kuvan synkronointi koko tuloksesta. Kun teet muokkauksen, nimeä konkreettinen puuttuva yksityiskohta ja säilytä kohtauksen onnistuneet osat sen sijaan, että korvaisit koko suunnitelman siihen liittymättömillä ohjeilla.
Ailoot Ultra · Videot POST /v1/videos doubao-seedance-2-5-260628
doubao-seedance-2-5-260628Aloitus
Seedance 2.5 luo videoita tekstin sekä kuva-, video- tai ääniviitteiden perusteella ja tarjoaa dokumentoidut työnkulut muokkaamiseen ja jatkamiseen. Sen täsmällisessä 2.5-esimerkissä tuotekuva yhdistetään useisiin liikeviitteisiin ja luotu ääni otetaan käyttöön yhtenäistä mainosjaksoa varten.
- Hyväksytyt syötteet
- Teksti · Kuvat · Video · Ääni
- Tulokset
- Video
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Videot POST /v1/videos
- Syötetyypit
text,image,video,audio- Tulostyypit
video
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat doubao-seedance-2-5-260628 | 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ägenerate_audio | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Ehdot: Version 2.5 esimerkki asettaa arvon true, mutta kopioitu valitsimen kuvaus luettelee vain versiot 2.0/fast/1.5; laajempaa asetuksen tai oletusarvon takuuta ei ole. | Oletus— |
Kenttäduration | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Ehdot: Version 2.5 esimerkin kirjaimellinen arvo 15 ei ole enimmäis- tai oletusarvo. | Oletus— |
Kenttäresolution | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Kopioiduista kuvauksista ei päätellä version 2.5 omia oletusarvoja tai enum-arvoja. | Oletus— |
Kenttäratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Adaptive on rajattu nimenomaisesti versioihin 2.0/fast/1.5; version 2.5 esimerkissä on vain 16:9. | Oletus— |
Kenttäwatermark | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttäseed | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: −1 Enimmäismäärä: 4 294 967 295 | Oletus−1 |
Kenttäexecution_expires_after | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 3 600 Enimmäismäärä: 259 200 Yksikkö: sekuntia | Oletus172 800 |
Kenttäservice_tier | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: 2.0/fast sulkevat pois offline-tilan flex; version 2.5 soveltamisalaa ei ole vahvistettu. | Oletus— |
Kenttäsafety_identifier | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Syöteaineistojen yhdistelmät
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimuscontent, model |
Parametrioptional | Sopimusgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier |
Parametrimaterial_types | Sopimustext, image, video, audio |
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. |
Parametrimaterial_combinations | Sopimustext, image, video, image, audio, image, video, video, audio, image, video, audio |
Parametrioptional_text_with_media | Sopimustrue |
Parametrireference_media_count_and_size_limits | Sopimusnull |
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 |
| AsetuksetSyöte sisältää videoviitteen. | Hinnasto— | Ennustettu määrä— | Laskutusyksikkö1K videotokenia kohden | Veloitus Tuloste · Arvio vain vertailua varten $0.012 1K videotokenia kohden |
| AsetuksetSyöte ei sisällä videoviitettä. | Hinnasto— | Ennustettu määrä— | Laskutusyksikkö1K videotokenia kohden | Veloitus Tuloste · Arvio vain vertailua varten $0.02 1K videotokenia kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.822402 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-2-5-260628","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}]}
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-2-5-260628
Menetelmäpolkujen aliakset
/v1/videos/generations
Liittyvät kutsujan ID:t
FAQ · ByteDance: Seedance 2.5
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·doubao-seedance-2-5-260628:text,image,video,audio→video- Mitä kenttiä pyyntö käyttää?
POST /v1/videos·doubao-seedance-2-5-260628:model,content,generate_audio,duration,resolution,ratio,watermark,seed,execution_expires_after,service_tier,safety_identifier- Mitä rajoja sovelletaan?
POST /v1/videos·doubao-seedance-2-5-260628:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200