ByteDance: Seedance 2.0
ByteDance Seedance 2.0 združuje izvorno ustvarjanje zvoka in videa s slikovnimi, video in zvočnimi referencami. Režirajte nove prizore, uredite obstoječe posnetke ali podaljšajte zaporedje; standardna izdaja vključuje dokumentirani izhod 1080p in 10-bitni 4K.
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.0 je standardni model podjetja ByteDance Seed za večmodalno ustvarjanje zvoka in videa. V arhitekturi skupnega ustvarjanja združuje besedilo, slike, videe in zvok, z ločenimi ustvarjalnimi poteki za prizore, vodene z referencami, urejanje videa in podaljševanje videa. Uporaben je, kadar izhodišče potrebuje povezano izvedbo in določene vizualne ali zvočne informacije iz pripravljenega gradiva.
Večmodalne reference in režijski nadzor
Slike lahko določijo videz subjekta, vizualni slog in kompozicijo. Video reference lahko usmerjajo dejanje, gibanje kamere in učinke. Zvok lahko usmerja barvo glasu, glasbo ali dialog. Določite vlogo vsakega gradiva, nato pa opišite prizor, ki naj nastane. Proizvajalec poudarja nadzor izvedbe, osvetlitve, senc in jezika kamere.
Za zgodbo izdelka pripravite sliko izdelka, referenco premika kamere in zvočni namig. Izhodišče bi lahko bilo: »Ohrani modro stekleno vazo iz Image 1. Uporabi počasni bočni premik kamere iz Video 1. Vaza stoji na sončni polici s tiho instrumentalno glasbo na podlagi Audio 1.« Predvideni izhod je na novo postavljen prizor, ki združuje izbrane referenčne informacije.
Referenčni vnosi lahko združujejo sliko in zvok, sliko in video, video in zvok ali vse tri. Vnos samo z zvokom ter besedilo z zvokom brez slike ali videa nista podprta. Dokumentirani so tudi običajna pretvorba besedila v video, ustvarjanje s prvim kadrom ter ustvarjanje s prvim in zadnjim kadrom. Če sta pomembni fiksni uvodna in zaključna kompozicija, uporabite namenski potek mejnih kadrov: poimenovanje referenčne slike kot končne točke znotraj navodila omni-reference je le posreden način usmerjanja.
Urejanje posnetkov
Model lahko zamenja subjekt, doda ali odstrani predmete, spremeni elemente ter znova izriše ali popravi dele videa. Opišite konkretno spremembo in določite izvorni posnetek. Pri dodajanju vključite čas pojava in položaj; pri odstranjevanju ali zamenjavi predmet natančno navedite in poimenujte, kaj naj ostane.
Na primer: »Namizno svetilko v Video 1 zamenjaj z medeninasto svetilko iz Image 1. Ohrani gibanje kamere, razporeditev mize in smer osvetlitve.« Želeni rezultat je urejena različica prizora s predvideno zamenjavo. Preglejte nespremenjena območja in novi predmet, zlasti med zakrivanjem, gibanjem in menjavami kadrov.
Podaljševanje in povezovanje zaporedja
Seedance 2.0 lahko video podaljša naprej ali nazaj in poveže do tri posredovane izseke z ustvarjenimi prehodi. Določite časovno smer in novi dogodek. Pri povezavi razvrstite izseke ter opišite prehod med vsakim parom, na primer kamero, ki v enem kadru vstopi skozi vrata in prispe v naslednje okolje.
Preprosto podaljševanje običajno vrne nadaljevanje, razvito okoli izvornega posnetka; vključite jasno navodilo, če naj končni rezultat ponovi tudi izvirni segment. Pri dopolnjevanju povezave med dvema ali tremi izseki lahko dokumentirani potek vključi izvirno gradivo in novo prehodno vsebino. To je uporabno za razvoj začetka ali konca oziroma za povezovanje pripravljenih prizorov brez neopredeljenega povezovalnega dejanja.
Izhod standardne izdaje in 4K
Standardna izdaja dokumentira MP4 pri 24 fps in trajanja od 4 do 15 sekund. Izhodne ravni so 480p, 720p in 1080p z 8-bitno barvno globino ter 4K z 10-bitno barvno globino. Podprta razmerja so 21:9, 16:9, 4:3, 1:1, 3:4 in 9:16. Dokumentirana sta tudi prilagodljivo kadriranje in samodejna izbira trajanja. Izdaja Fast ima svojo ožjo izhodno specifikacijo 480p/720p.
Izhod 4K uporablja kodiranje H.265/HEVC. Desetbitno kodiranje ohrani dodatne tonske stopnje in bolj gladke barvne prehode, kar je pomembno pri gradivu z nežnimi svetlobnimi ali barvnimi prelivi. Preverite, ali predvideno okolje predvajanja in urejanja lahko dekodira ta format; nekateri brskalniki in naprave ga ne predvajajo neposredno. Združljiv vsebnik sam po sebi ne zagotavlja združljivega dekodiranja videa.
Model lahko ustvari sinhroniziran zvok ali nemi video ter vrne zadnji ustvarjeni kader za naslednji prizor. Ustvarjeni zvok je mono. Družina 2.0 ne podpira ločenega dvostopenjskega načina predogleda Draft, zato o podpori tej funkciji predogleda ne smete sklepati na podlagi druge izdaje Seedance.
Priprava referenc in bistvene omejitve
Dokumentirana zmogljivost referenc je do devet slik, trije videi in trije zvočni izseki. Neposredno nalaganje referenčnih slik ali videov z resničnimi človeškimi obrazi v tem dokumentiranem proizvajalčevem profilu ni sprejeto; portretno delo uporablja njegov podprti potek portretnih virov. Vsak video in zvočni izsek mora trajati 2–15 sekund. Vse video reference skupaj se morajo prilegati 15 sekundam, vse zvočne reference skupaj pa imajo svojo skupno omejitev 15 sekund. Video datoteke uporabljajo MP4 ali MOV pri 24–60 fps, do 200 MB vsaka; zvočne datoteke uporabljajo WAV ali MP3, do 15 MB vsaka. Navedeni slikovni formati so JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC in HEIF. Vsaka slika mora biti manjša od 30 MB, telo zahteve pa ne sme presegati 64 MB. V dokumentiranem profilu referenčnega vnosa morata biti širina in višina slike vsaka strogo med 300 in 6,000 slikovnimi pikami, razmerje širine in višine pa strogo med 0.4 in 2.5. Referenčni videi dovoljujejo 300–6,000 slikovnih pik v vsaki dimenziji in razmerja 0.4–2.5, vključno z mejami, s skupno 407,696–8,295,044 slikovnimi pikami. Videi MP4 ali MOV uporabljajo video H.264/AVC ali H.265/HEVC in zvok AAC ali MP3.
Datoteke premišljeno razvrstite in se na vsako sklicujte z vrsto medija in številko: Image 1, Video 1 in Audio 1. Številka sledi vrstnemu redu med datotekami iste vrste. Pojasnite, katere lastnosti je treba prenesti in katera izvorna vsebina ne sme določati novega prizora. Dokumentirani jeziki navodil vključujejo angleščino, španščino, indonezijščino, portugalščino in japonščino. Govorjeni jezik naj bo dosleden znotraj dialoga; vodnik odsvetuje mešanje jezikov razen lastnih imen. Pri delu, vodenem z glasom, ločite govorca, točno vrstico in navodilo za podajanje.
Prvo in zadnjo sliko pripravite z združljivim kadriranjem. Neskladje med vhodno sliko in izhodnimi dimenzijami lahko povzroči obrezovanje ali nenadno vizualno spremembo; ujemajoče se dimenzije in prilagodljivo kadriranje sta dokumentirani rešitvi. Opis osredotočite na dogodek in referenčne vloge. Proizvajalec opozarja, da lahko dolga navodila razpršijo informacije, zato so podrobnosti prezrte. Nastalo gibanje, referenčno kontinuiteto, zvočno izvedbo in spoje med prizori preverite kot ločene dele ustvarjalnega rezultata.
Načrtovanje kadrov in usmerjanje besedila
Pri zapletenem prizoru izhodišče uredite kot Kader 1, Kader 2 in Kader 3 ter po vrsti določite kamero, dejanje subjekta, položaj in zvok. Vodnik priporoča en premik kamere na kader in dajanje prednosti počasnim, povezanim dejanjem. Natančne časovne oznake posameznih kadrov so nestabilne, zato je zaporedje dogodkov boljši nadzor kot vsiljevanje več točnih časovnih oken.
Model ustvarja tudi običajno besedilo, vključno s slogani, podnapisi in govornimi oblački. Določite lahko barvo besedila, vizualno obdelavo, lokacijo in pojavitev. Uporabite običajne znake namesto redkih znakov ali posebnih simbolov ter besedilo preverite med gibanjem. Pri referencah subjektov vsak vir jasno povežite s predvidenim likom ali predmetom. Pogledi na izdelek lahko zagotavljajo različne vizualne informacije; kolaži lika iz več pogledov lahko zmedejo obrazno identiteto. Dokumentirano priporočilo za referenco lika sta ločena jasna portretna slika in slika celotnega telesa.
Vedenja za pregled pred montažo
Vodnik dokumentira neželene podnapise, logotipe, podvojene like in slogovna odstopanja. Čisto izvorno gradivo, dosledne oznake in izrecne omejitve zmanjšajo ta tveganja, ne zagotavljajo pa izginotja neželenega besedila ali podvojenih figur. Več kot štiri referenčne osebe so navedene kot tveganje za stabilnost, ločeno od števila datotek, ki jih model sprejema.
Podaljševanje videa lahko ustvari preskok ali vrnitev na spoju, ponavljajoča se nadaljevanja pa lahko kopičijo poslabšanje kakovosti slike. Preglejte mejne kadre in omejite nizanje podaljševanj. Referenčni glas se lahko razlikuje od izvorne barve glasu; pripoved se lahko konča s klikom ali nenadnim odrezom, za kar je zvočni pojemek dokumentirana rešitev. Kitajski znaki z več izgovarjavami, neobičajni znaki ali podobno oblikovani znaki so lahko napačno izgovorjeni. Pri natančnem animiranem učinku, kot je odštevanje, je gibalna referenca bolj informativna od same besedne zahteve. To so konkretni razlogi za ločeno preverjanje identitete, besedila, gibanja in zvoka pri izbiri izseka.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Začetek
ByteDance Seedance 2.0 združuje izvorno ustvarjanje zvoka in videa s slikovnimi, video in zvočnimi referencami. Režirajte nove prizore, uredite obstoječe posnetke ali podaljšajte zaporedje; standardna izdaja vključuje dokumentirani izhod 1080p in 10-bitni 4K.
- Dovoljeni vhodi
- Besedilo · Slike · Zvok
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Video POST /v1/videos
- Vhod
text,image,audio- Izhod
video- Izhodni format
- izvirni bajti MP4; brez normalizacije ali prekodiranja
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve bytedance/seedance-2.0 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Najmanj: 1 Največ: 600 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480p, 720p, 1080p, 4K | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Privzeto— |
Poljegenerate_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve false, true Pogoji: Pri 480p in 720p izpustitev generate_audio izbere ceno z zvokom, false pa ceno brez zvoka. Pri 1080p in 4K velja cena ločljivosti pri obeh nastavitvah. Za vrnjeni zvočni posnetek preverite has_audio v rezultatu. | Privzeto— |
Poljeframe_images | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 2 Vhodna vsebina: Polje objektov sličic. Vsak vsebuje type=image_url, image_url z url in frame_type=first_frame ali last_frame. Vsaka vloga se lahko pojavi največ enkrat. Uporabite javne URL-je HTTPS. Natančni ključi: type, image_url, frame_type Pogoji: Ti ključi veljajo za vsak objekt sličice. Pri zahtevi samo z besedilom izpustite frame_images. | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Vhodna vsebina: Polje objektov slikovnih ali zvočnih referenc. Nastavite type na image_url ali audio_url ter podajte ustrezni objekt URL, ki vsebuje url. Video referenc še vedno ni mogoče ovrednotiti. Pogoji: Za referenčni način izpustite frame_images. Uporabite javne URL-je HTTPS. | Privzeto— |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Vzorec: ^[1-9][0-9]*x[1-9][0-9]*$ | Privzeto— |
Poljeseed | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: −9.223.372.036.854.775.808 Največ: 9.223.372.036.854.775.807 | Privzeto— |
Poljecallback_url | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Vzorec: ^https:// | Privzeto— |
Poljesession_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetrace | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljeuser | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Kombinacije vhodnih gradiv
Iz besedila v video · Pisni poziv. · Obvezno: model, prompt, duration
Podajte besedilni poziv in podprto trajanje v celih sekundah. Uporabite natančno navedeno velikost ali ločljivost in razmerje stranic, ki določata navedene mere.
model: Vrsta: string · bytedance/seedance-2.0
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Iz slike v video · Pisni poziv in slika sličice. · Obvezno: model, prompt, duration, frame_images
frame_images je polje objektov s type=image_url, image_url, ki vsebuje url, in frame_type. Uporabite javni URL slike HTTPS; first_frame in last_frame se lahko pojavita vsak po enkrat. Uporabite navedeno velikost izhoda ali združljive mere. Ne dodajajte video referenc.
Natančni ključi: type, image_url, frame_type
model: Vrsta: string · bytedance/seedance-2.0
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Reference to video · Pisni poziv in slikovne ali zvočne reference. · Obvezno: model, prompt, duration, input_references
input_references je polje. Vsak objekt vsebuje type=image_url ali type=audio_url in ustrezni objekt URL, ki vsebuje url. Uporabite javne povezave HTTPS. Za izbiro referenčnega načina izpustite frame_images. Video referenc ni mogoče ovrednotiti.
model: Vrsta: string · bytedance/seedance-2.0
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt, duration |
Parametermaterial_types | Specifikacijatext, image, audio |
Parameteradditional_properties | Specifikacijafalse |
Parameteroptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Življenjski cikel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Obračunski pogoji | Strošek |
|---|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Obračunski pogoji— | 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 |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojiV tem cenovnem ključu ni naveden noben dodaten pogoj. | Strošek Izhod · Cena žetona videa · Ocena samo za primerjavo $0.014 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojiresolution: 1080p | Strošek Izhod · Cena žetona videa · Ocena samo za primerjavo $0.0154 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojivhod: with_video_input; ločljivost: 1080p | Strošek reference · Cena žetona videa · Ocena samo za primerjavo $0.0094 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojiresolution: 4k | Strošek Izhod · Cena žetona videa · Ocena samo za primerjavo $0.008 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojivhod: with_video_input; ločljivost: 4k | Strošek reference · Cena žetona videa · Ocena samo za primerjavo $0.0048 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojivhod: with_video_input | Strošek reference · Cena žetona videa · Ocena samo za primerjavo $0.0086 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Cenovna lestvica— | Predvidena količina— | Obračunska enotana 1K video žetonov | Obračunski pogojizvok: without_audio | Strošek Izhod · Cena žetona videa · Ocena samo za primerjavo $0.014 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Obračunski pogoji— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.3024 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 →
Podrobnosti referenčne tarife
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
Cenovne reference konfiguracij videa
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| NastavitevCena video žetona | Obračunski pogojiV tem cenovnem ključu ni naveden noben dodaten pogoj. | Strošek Izhod · Cena žetona videa $0.014 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Obračunski pogojiresolution: 4k | Strošek Izhod · Cena žetona videa $0.008 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Obračunski pogojiresolution: 1080p | Strošek Izhod · Cena žetona videa $0.0154 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Obračunski pogojizvok: without_audio | Strošek Izhod · Cena žetona videa $0.014 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Obračunski pogojivhod: with_video_input | Strošek reference · Cena žetona videa $0.0086 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Obračunski pogojivhod: with_video_input; ločljivost: 4k | Strošek reference · Cena žetona videa $0.0048 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
| NastavitevCena video žetona | Obračunski pogojivhod: with_video_input; ločljivost: 1080p | Strošek reference · Cena žetona videa $0.0094 na 1K video žetonov Cena videožetonov je glavna referenčna cena. Okvirne ocene na sekundo so ločene reference in ne pomenijo dodatnega plačila. |
Primeri zahtev
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Prejmi in shrani rezultate
Ailoot Ultra · Video
podpisani URL-ji vsebine v vaši lasti
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Preveri stanje opravila
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Branje druge vsebine
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak dejanski izhod v vaši lasti in njegove vrnjene izmerjene metapodatke.
Če je treba preveriti izvirni odgovor
503 result_pending_check + prvotni id + X-Should-Retry:false; prvotne zahteve nikoli ne ponovite
Polja odgovora
| Polje | Vrsta | Pomen |
|---|---|---|
Poljeindex | Vrstainteger | PomenPoložaj tega videa na seznamu izhodov, štet od nič. |
Poljecontent_url | Vrstastring | PomenPodpisani URL HTTPS za prenos tega dokončanega videa. |
Poljesha256 | Vrstastring | null | PomenIzvleček SHA-256 izvirnih video bajtov; null, če ni na voljo. |
Poljesize_bytes | Vrstainteger | null | PomenVelikost izvirne video datoteke v bajtih; null, če ni na voljo. |
Poljeduration_ms | Vrstainteger | null | PomenIzmerjeno trajanje videa v milisekundah; null, če ni na voljo. |
Poljewidth | Vrstainteger | null | PomenŠirina videa v slikovnih pikah; null, če ni na voljo. |
Poljeheight | Vrstainteger | null | PomenVišina videa v slikovnih pikah; null, če ni na voljo. |
Poljevideo_codec | Vrstastring | null | PomenIdentifikator video kodeka; null, če ni zabeležen. |
Poljehas_audio | Vrstaboolean | null | PomenAli video vsebuje zvočno sled; null, če ni izmerjeno. |
Poljeaudio_codec | Vrstastring | null | PomenIdentifikator zvočnega kodeka; null, kadar identifikator ni zabeležen. |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor404 · not_found_error | PogojDostop do videa ni na voljo ali ta ID videa ni bil najden. | Naslednji korakPreverite dostop do videa. Za obstoječi video uporabite njegov prvotni javni ID in isti ključ API. |
Odgovor401 · authentication_error | PogojKljuč API se ne ujema z overjenim računom. | Naslednji korakPred oddajo preverite svoj ključ API in dostop do računa. |
Odgovor400 · invalid_request_error | PogojZahteve ni bilo mogoče prebrati ali je indeks prenosa neveljaven. | Naslednji korakPopravite telo zahteve. Pri prenosu izberite indeks izhoda, ki ga je vrnilo prvotno opravilo. |
Odgovor422 · price_unavailable | PogojIzbrane video konfiguracije ni mogoče ovrednotiti. | Naslednji korakIzberite podprto konfiguracijo videa in izpolnite njene obvezne možnosti, preden oddate popravljeno zahtevo. |
Odgovor422 · invalid_request_error | PogojVideo vhod ali prvotno nadaljevalno opravilo ni veljavno. | Naslednji korakUporabite veljavne vhode HTTPS. Za nadaljevanje uporabite javni ID svojega dokončanega prvotnega videa z istim ključem API. |
Odgovor402 · billing_error | PogojRazpoložljivo dobroimetje ali omejitve ne omogočajo rezervacije. | Naslednji korakPreden pošljete novo zahtevo, preverite razpoložljivo dobroimetje in omejitve. |
Odgovor503 · server_error | PogojPreverjanje videa, shramba ali dostop do storitve začasno ni na voljo. | Naslednji korakPočakajte, da bo storitev na voljo. Če že imate ID videa, preverite to prvotno opravilo, namesto da ustvarite novo generacijo. |
Odgovor503 · result_pending_check | PogojPrvotni video rezultat in zaračunani znesek je treba preveriti. | Naslednji korakOhranite vrnjeni ID videa in preverjajte to opravilo. Med preverjanjem ne pošljite nadomestne zahteve za ustvarjanje. |
Odgovor503 · owned_result_unavailable | PogojPrenos obstoječega videa začasno ni na voljo. | Naslednji korakPozneje preverite isto video opravilo in prenesite njegov obstoječi izhod. Novo ustvarjanje ustvari ločeno operacijo. |
Odgovor409 · video_not_ready | PogojVideo vsebina ni objavljena. | Naslednji korakPreverite stanje prvotnega opravila. Prenesite, ko sporoči completed; če sporoči failed, upoštevajte njegovo obvestilo o preverjanju zaračunanega zneska. |
Druga imena
Druga imena modelov
Ailoot Ultra bytedance/seedance-2.0
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · ByteDance: Seedance 2.0
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Katera polja uporablja zahteva?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Katere omejitve veljajo?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807