ByteDance: Seedance 2.5
Seedance 2.5 ustvari video iz besedila ter slikovnih, video- ali zvočnih referenc z dokumentiranimi postopki urejanja in podaljševanja. Njegov konkretni primer 2.5 združi sliko izdelka z več referencami gibanja in vklopi ustvarjeni zvok za usklajeno oglaševalsko zaporedje.
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 2.5 ustvari video s pisnim opisom prizora in večmodalnimi referencami. Konkretni identifikator doubao-seedance-2-5-260628 ima lastno dokumentirano operacijo in primer. Ta operacija opisuje ustvarjanje, urejanje in podaljševanje videa s slikami, videom, zvokom in besedilom kot vhodnimi mediji. Z referencami sporočite videz glavnega motiva, dejanje, gibanje kamere, slog in zvok, nato pojasnite rezultat, ki naj nastane iz njih.
Vhodne kombinacije vključujejo samo besedilo, slike ali video z neobveznim besedilom, slike z zvokom, video z zvokom ter slike, video in zvok skupaj. Navedene kombinacije pripenjajo zvok vizualnim medijem, ne opisujejo pa zahteve samo z zvokom. Vsako postavko uredite glede na njeno vlogo: slika določi glavni motiv ali videz, video prikaže gibanje ali obstoječi prizor, zvok pa poda zvočno referenco. Določite, katera vloga je pomembna za zahtevani kader, da reference ozadja ne bo mogoče zamenjati za glavni lik.
Konkretni primer 2.5 je produktno oglaševalsko zaporedje. Poda sliko in več videoreferenc, nato opiše začetno središče pozornosti, urejene razporeditve izdelkov, kadre podrobnosti, upočasnjeno dejanje in končno kompozicijo znamke. Zahteva dodeli vlogi reference_image in reference_video ter posamezne reference uporabi za kompozicijo, gibanje, delo kamere in učinek. To daje praktično zgradbo zamisli za kampanjo: načrtujte vidne faze, določite referenco za vsako fazo in opredelite končno razporeditev.
Pisno zaporedje lahko loči, kaj se dogaja, od tega, kako je posneto. Najprej opišite, kaj se dogaja z izdelkom, nato velikost plana, pot kamere, tempo in prehod na naslednji pogled. Če ena referenca določa izdelek, druga pa prikaže gibanje kamere, poimenujte ti ločeni nalogi. Pri prizoru z več predmeti pojasnite njihove položaje in vrstni red medsebojnih interakcij. V ustvarjenem rezultatu preverite dejansko obliko izdelka, razporeditev in gibanje, namesto da predpostavljate, da se vsaka podrobnost reference pojavi nespremenjena.
Pri urejanju določite obstoječi video in element za predelavo, na primer okolje, dejanje ali vizualni slog, ter navedite kontinuiteto, ki jo je treba ohraniti. Pri podaljševanju opišite, kako naj se prizor nadaljuje iz podanega posnetka. Preverite spoj in novi del: videz glavnega motiva, smer gibanja, položaj kamere in časovni potek zvoka vplivajo na to, ali je rezultat videti kot en prizor. Izvorni video in končano predelavo hranite skupaj, da boste lahko preverili, ali sprememba ohranja predvideno kontinuiteto.
Dokumentirani večmodalni primer 2.5 nastavi generate_audio=true in zahteva petnajstsekundno zaporedje s formatom 16:9. Te vrednosti opisujejo ta primer, ne splošne zgornje meje trajanja ali omejitve referenčnih gradiv. Jasno opredelite zvočno zamisel zahtevanega prizora, vključno s povezavo med glasbo, učinki in vidnim dejanjem, nato ocenite dejanski avdiovizualni izhod. Zvočno referenco in ustvarjeno zvočno podlago preverite skupaj glede predvidenega tempa in izvedbe.
Trajanje, kompozicijo in ločljivost izberite med nastavitvami, ki so na voljo za ta konkretni profil. Zahtevano konfiguracijo shranite skupaj s pozivom in jo primerjajte z dejansko vrnjenimi polji naloge. Pri pripravi končanega posnetka za končno uporabo uporabite vrnjene trajanje, ločljivost in razmerje. V zapisu različice ohranite natančni identifikator profila, da bo poznejša primerjava uporabljala isto izbrano izdajo.
Poraba videožetonov se izračuna kot (trajanje vhodnega videa + trajanje izhodnega videa) × širina izhoda × višina izhoda × hitrost izhodnih sličic / 1024. Zahteve z vhodnim videom in zahteve brez njega imajo ločene obračunske kategorije. Poizvedba o nalogi sporoči usage.completion_tokens in usage.total_tokens; sporočeni količini shranite skupaj s končanim posnetkom.
Ustvarjanje poteka asinhrono. Oddaja vrne identifikator, nastavljeni postopek naloge pa poda stanje in po uspešnem zaključku content.video_url. Končani posnetek shranite skupaj z izvornimi mediji in navodilom za zaporedje. V celotnem rezultatu preverite vse načrtovane faze, interakcije predmetov, videz likov, kompozicijo in usklajenost zvoka. Pri predelavi določite konkretno spregledano podrobnost ter ohranite uspešne dele prizora, namesto da celotno navodilo zamenjate z nepovezanimi napotki.
Ailoot Ultra · Videoposnetki POST /v1/videos doubao-seedance-2-5-260628
doubao-seedance-2-5-260628Začetek
Seedance 2.5 ustvari video iz besedila ter slikovnih, video- ali zvočnih referenc z dokumentiranimi postopki urejanja in podaljševanja. Njegov konkretni primer 2.5 združi sliko izdelka z več referencami gibanja in vklopi ustvarjeni zvok za usklajeno oglaševalsko zaporedje.
- Dovoljeni vhodi
- Besedilo · Slike · Video · Zvok
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Videoposnetki POST /v1/videos
- Vhod
text,image,video,audio- Izhod
video
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve doubao-seedance-2-5-260628 | 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— |
Poljegenerate_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Primer za 2.5 nastavi true, vendar prekopirani opis izbirnika navaja samo 2.0/fast/1.5; širša nastavitev/privzeta vrednost ni zagotovljena. | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Dobesedna vrednost 15 v primeru za 2.5 ni največja ali privzeta vrednost. | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Privzeta vrednost/enum za 2.5 se ne sklepa iz prekopiranih opisov. | Privzeto— |
Poljeratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Adaptive je izrecno omejen na 2.0/fast/1.5; primer za 2.5 uporablja samo 16:9. | Privzeto— |
Poljewatermark | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljeseed | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: −1 Največ: 4.294.967.295 | Privzeto−1 |
Poljeexecution_expires_after | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 3600 Največ: 259.200 Enota: sekunde | Privzeto172.800 |
Poljeservice_tier | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: 2.0/fast izključujeta offline flex; obseg za 2.5 ni določen. | Privzeto— |
Poljesafety_identifier | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Kombinacije vhodnih gradiv
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijacontent, model |
Parameteroptional | Specifikacijagenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier |
Parametermaterial_types | Specifikacijatext, image, video, audio |
Parameteradditional_properties | Specifikacijatrue |
Parametervalidation_scope | SpecifikacijaAiloot preveri obvezne vrste polj in neprazno polje model/content. Druga polja zahteve se ohranijo za izbrani model. |
Parametermaterial_combinations | Specifikacijatext, image, video, image, audio, image, video, video, audio, image, video, audio |
Parameteroptional_text_with_media | Specifikacijatrue |
Parameterreference_media_count_and_size_limits | Specifikacijanull |
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 |
| NastavitevVhod vsebuje video. | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.012 na 1K video žetonov |
| NastavitevVhod ne vsebuje videa. | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Strošek Izhod · Ocena samo za primerjavo $0.02 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.822402 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-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
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-2-5-260628
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · ByteDance: Seedance 2.5
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·doubao-seedance-2-5-260628:text,image,video,audio→video- Katera polja uporablja zahteva?
POST /v1/videos·doubao-seedance-2-5-260628:model,content,generate_audio,duration,resolution,ratio,watermark,seed,execution_expires_after,service_tier,safety_identifier- Katere omejitve veljajo?
POST /v1/videos·doubao-seedance-2-5-260628:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200