ByteDance: Seedance 2.0 Fast
ByteDance Seedance 2.0 Fast kuria garso ir vaizdo scenas iš teksto, vaizdų, vaizdo bei garso etalonų. Į greitį orientuota versija palaiko judesio ir stiliaus perkėlimą, vaizdo taisymus bei pratęsimą pirmyn arba atgal su dokumentuota 480p ir 720p išvestimi.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Seedance 2.0 Fast yra į greitį orientuota ByteDance Seed Seedance 2.0 šeimos versija. Ji palaiko bendrą vaizdo ir garso generavimą bei daugiarūšę užduotį, sudarytą iš teksto, vaizdų, vaizdo ir garso. Kūrybinės galimybės apima naujas etalonais grindžiamas scenas, esamos medžiagos taisymus ir scenos pratęsimus, o dokumentuoti išvesties lygiai yra 480p ir 720p.
Daugiarūšiai etalonai: medžiagos vaidmenų paskyrimas
Vaizdas gali pateikti veikėją, produktą, kompoziciją ar vizualinį perteikimą. Etaloninis vaizdo įrašas gali pateikti veiksmą, kameros judėjimą ar efektą. Etaloninis garsas gali pateikti balso tembrą, muzikinę melodiją ar dialogo turinį. Paaiškinkite, kurią kiekvieno šaltinio dalį norite perkelti į naują sceną; etalonas naudingesnis, kai turi konkretų kūrybinį vaidmenį.
Pavyzdžiui: „Kaip produktą naudokite keraminį šviestuvą iš Image 1. Sekite lėtą kameros judėjimą ratu iš Video 1, tačiau šviestuvą pastatykite ramiame skaitymo kampelyje. Muzikinei nuotaikai naudokite Audio 1.“ Numatytas rezultatas yra nauja scena, jungianti pasirinktą išvaizdą, judėjimą ir garsinę kryptį, o ne neapibrėžtas visų etalonų detalių mėgdžiojimas.
Dokumentuoti deriniai apima vaizdus su garsu, vaizdus su vaizdo įrašu, vaizdo įrašą su garsu ir visus tris kartu. Tekstas vien su garsu ir vien garso įvestis nepalaikomi. Modelis taip pat palaiko vaizdo kūrimą iš teksto ir vaizdu grindžiamą generavimą iš pirmojo kadro arba pirmojo ir paskutiniojo kadrų poros. Kai tikslus galinis taškas yra esminis užduočiai, naudokite specialų ribinių kadrų procesą; etaloninio vaizdo aprašymas kaip galinio taško omni etalonų užklausoje yra netiesioginis valdymas.
Esamo vaizdo įrašo redagavimas
Modelis gali pridėti, pašalinti ar pakeisti elementus, pakeisti subjektą ir perpiešti ar pataisyti scenos dalis. Nurodykite šaltinio vaizdo įrašą, keičiamą objektą ir elementus, kurie turi likti. Pridėjimui aprašykite, kur ir kada jis pasirodo. Šalinimui visame klipe nuosekliai įvardykite objektą.
Praktinė redagavimo užduotis galėtų paprastą butelį demonstracijoje pakeisti buteliu iš Image 1, prašant išsaugoti Video 1 rankos judesį, foną ir kameros kelią. Patikrinkite ir pakeitimą, ir stabilias išlikti turėjusias sritis. Aiškios išsaugojimo instrukcijos leidžia lengviau įvertinti numatytą taisymą nei bendras prašymas „pagerinti“ medžiagą.
Klipų pratęsimas ir sujungimas
Seedance 2.0 Fast palaiko pratęsimą pirmyn arba atgal ir dviejų ar trijų klipų sujungimą sugeneruotais perėjimais. Pratęsimui nurodykite, ar naujas veiksmas vyksta prieš pateiktą vaizdo įrašą, ar po jo, ir tą veiksmą aprašykite. Sujungimui pateikite klipus numatyta tvarka ir paaiškinkite juos jungiantį vizualinį įvykį.
Paprastas pratęsimas paprastai grąžina naujai išplėtotą tęsinį aplink originalią medžiagą, o ne daro prielaidą, kad visas šaltinio klipas kartojamas. Jei išvestis turi apimti originalų segmentą, nurodykite tai užduotyje. Užpildant perėjimą tarp dviejų ar trijų vaizdo įrašų dokumentuotas procesas gali sujungti originalų ir naujai sugeneruotą turinį. Tai naudinga bendram produkto vaizdui susieti su detaliu kadru per tikslingą kameros judesį.
Išvestis ir versijų skirtumai
Dokumentuota Fast išvestis yra MP4 su 24 fps, 480p arba 720p, 8 bitų spalvos gyliu ir 4–15 sekundžių klipais. Palaikomi santykiai yra 21:9, 16:9, 4:3, 1:1, 3:4 ir 9:16. Standartinė Seedance 2.0 versija atskirai nurodo 1080p ir 4K išvestį; šie lygiai nėra Fast specifikacijos dalis. 2.0 šeima palaiko paskutinio sugeneruoto kadro grąžinimą, tačiau nepalaiko atskiro Draft peržiūros režimo.
Garsą galima generuoti kartu su medžiaga arba jo atsisakyti tyliam klipui. Sugeneruotas garsas yra mono. Dokumentuotos užklausų kalbos apima anglų, ispanų, indoneziečių, portugalų ir japonų. Viename dialoge išlaikykite nuoseklią sakytinę kalbą; vadovas pataria nemaišyti kalbų, išskyrus tikrinius vardus. Kalbamai scenai įvardykite kalbėtoją ir frazę rašykite kabutėse, tada nurodykite atlikimą bei susijusius garso efektus. Reikalaujamą atlikimą pritaikykite pasirinkto klipo trukmei.
Etalonų paruošimas ir įvesties ribų laikymasis
Dokumentuotos etalonų ribos yra iki devynių vaizdų, trijų vaizdo įrašų ir trijų garso klipų. Tiesioginiai etaloninių vaizdų ar vaizdo įrašų su tikrais žmonių veidais įkėlimai šiame dokumentuotame gamintojo profilyje nepriimami; portretų darbui naudojamas palaikomas portretinių išteklių procesas. Kiekvienas vaizdo ar garso klipas turi trukti 2–15 sekundžių; bendra vaizdo trukmė yra daugiausia 15 sekundžių, o bendra garso trukmė atskirai yra daugiausia 15 sekundžių. Vaizdo etalonai naudoja MP4 arba MOV su 24–60 fps ir neturi viršyti 200 MB kiekvienas. Garso etalonai naudoja WAV arba MP3 ir neturi viršyti 15 MB kiekvienas. Nurodyti vaizdų formatai yra JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ir HEIF. Kiekvienas vaizdas turi būti mažesnis nei 30 MB; bendra užklausos turinio riba – 64 MB. Dokumentuotame etalonų įvesties profilyje vaizdo plotis ir aukštis kiekvienas turi būti griežtai tarp 300 ir 6 000 pikselių, o pločio ir aukščio santykis – griežtai tarp 0.4 ir 2.5. Etaloniniai vaizdo įrašai leidžia 300–6 000 pikselių kiekvienam matmeniui ir santykius 0.4–2.5 imtinai, su 407 696–8 295 044 bendrų pikselių. MP4 ar MOV įrašai naudoja H.264/AVC arba H.265/HEVC vaizdą ir AAC arba MP3 garsą.
Išteklius išrikiuokite ir nuosekliai vadinkite Image 1, Video 1 ar Audio 1. Kartu su ištekliaus numeriu naudokite matomo subjekto vardą ar skiriamąjį bruožą. Ribinių vaizdų kadravimą derinkite su numatytu vaizdo įrašo santykiu, nes neatitikimas gali nukirpti vaizdą ar sukelti staigų kadravimo pokytį. Užduotį sutelkite į perkeliamas savybes, generuojamą įvykį ir tai, kas turi išlikti nepakitę; ilga užklausa gali išsklaidyti instrukcijas ir palikti antraeiles detales neišspręstas.
Kadrų planavimas, tekstas ir žinoma elgsena
Sudėtingą užduotį organizuokite kaip Shot 1, Shot 2 ir Shot 3, kiekvienam aiškiai nurodydami subjektą, veiksmą, vietą bei garsą. Vadovas rekomenduoja vieną kameros judesį vienam kadrui ir nurodo, kad tikslios atskirų kadrų laiko žymos nestabilios. Kiekvienam veikėjui suteikite stabilią žymą ir kelis skiriamuosius bruožus; kai svarbi veido tapatybė, vietoj bendro veikėjo vaizdų iš skirtingų pusių lapo naudokite atskirą aiškų galvos portretą ir viso kūno etaloną.
Modelis gali generuoti įprastą tekstą, įskaitant šūkius, subtitrus ir kalbos burbulus, su spalvos, stiliaus, vietos bei pasirodymo instrukcijomis. Įprasti rašmenys pageidautini labiau nei reti rašmenys ar specialieji simboliai. Patikrinkite raides judant. Nepageidaujami subtitrai, logotipai ir pasikartojantys veikėjai yra dokumentuota elgsena; aiškūs apribojimai ir švarūs etalonai gali ją sumažinti, bet negarantuoja nebuvimo. Daugiau nei keturi etaloniniai žmonės įvardijami kaip stabilumo rizika, o ne griežta failų skaičiaus riba.
Pakartotiniai pratęsimai gali kaupti vaizdo kokybės nuostolius, o pratęsimo sujungimas gali šoktelėti ar grįžti atgal. Ribokite nuoseklius pratęsimus ir montaže patikrinkite sujungimą. Etaloninio balso tembras gali nukrypti, pasakojimas gali baigtis spragtelėjimu, o kelis tarimo variantus turintys ar reti kinų rašmenys gali būti ištarti neteisingai. Patikrinkite sakytinę frazę ir pabaigos garsą; trumpas garso išblukimas gali padėti staigaus nukirtimo atveju. Šie patikrinimai priklauso kūrybinio rezultato paruošimui, ypač kai istoriją perteikia kalba ar veikėjų tęstinumas.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos bytedance/seedance-2.0-fast
bytedance/seedance-2.0-fastPradžia
ByteDance Seedance 2.0 Fast kuria garso ir vaizdo scenas iš teksto, vaizdų, vaizdo bei garso etalonų. Į greitį orientuota versija palaiko judesio ir stiliaus perkėlimą, vaizdo taisymus bei pratęsimą pirmyn arba atgal su dokumentuota 480p ir 720p išvestimi.
- Leidžiamos įvestys
- Tekstas · Vaizdai · Garsas
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image,audio- Išvestis
video- Išvesties formatas
- originalūs MP4 baitai; be normalizavimo ar perkodavimo
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos bytedance/seedance-2.0-fast | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mažiausia reikšmė: 1 Didžiausia reikšmė: 600 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480p, 720p | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Numatyta— |
Laukasgenerate_audio | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos false, true Sąlygos: Praleidus generate_audio taikoma kaina su garsu; false parenka kainą be garso. Rezultate patikrinkite has_audio, kad sužinotumėte, ar grąžintas garso takelis. | Numatyta— |
Laukasframe_images | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 2 Įvesties turinys: Kadrų objektų masyvas. Kiekviename yra type=image_url, image_url su url ir frame_type=first_frame arba last_frame. Kiekviena paskirtis nurodoma daugiausia vieną kartą. Naudokite viešus HTTPS URL. Tikslūs raktai: type, image_url, frame_type Sąlygos: Šie raktai taikomi kiekvienam kadro objektui. Jei užklausoje yra tik tekstas, praleiskite frame_images. | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Įvesties turinys: Pavyzdinių paveikslėlių arba garso objektų masyvas. Nustatykite type reikšmę image_url arba audio_url ir pateikite atitinkamą URL objektą su url. Pavyzdinių vaizdo įrašų kainos nustatyti vis dar negalima. Sąlygos: Kad naudotumėte pavyzdinės medžiagos režimą, praleiskite frame_images. Naudokite viešus HTTPS URL. | Numatyta— |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720 Šablonas: ^[1-9][0-9]*x[1-9][0-9]*$ | Numatyta— |
Laukasseed | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: −9 223 372 036 854 775 808 Didžiausia reikšmė: 9 223 372 036 854 775 807 | Numatyta— |
Laukascallback_url | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Šablonas: ^https:// | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastrace | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Įvesties medžiagos deriniai
Iš teksto į vaizdo įrašą · Tekstinė užklausa. · Privaloma: model, prompt, duration
Pateikite tekstinę užklausą ir palaikomą trukmę sveikomis sekundėmis. Naudokite tikslų išvardytą dydį arba skiriamąją gebą ir kraštinių santykį, kurie atitinka išvardytus matmenis.
model: Tipas: string · bytedance/seedance-2.0-fast
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Iš vaizdo į vaizdo įrašą · Tekstinė užklausa ir kadro paveikslėlis. · Privaloma: model, prompt, duration, frame_images
frame_images yra objektų masyvas su type=image_url, image_url, kuriame yra url, ir frame_type. Naudokite viešą HTTPS paveikslėlio URL; first_frame ir last_frame gali būti nurodyti po vieną kartą. Naudokite išvardytą išvesties dydį arba suderinamus matmenis. Nepridėkite pavyzdinių vaizdo įrašų.
Tikslūs raktai: type, image_url, frame_type
model: Tipas: string · bytedance/seedance-2.0-fast
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Reference to video · Tekstinė užklausa ir pavyzdiniai paveikslėliai arba garso įrašai. · Privaloma: model, prompt, duration, input_references
input_references yra masyvas. Kiekviename objekte yra type=image_url arba type=audio_url ir atitinkamas URL objektas su url. Naudokite viešas HTTPS nuorodas. Kad pasirinktumėte pavyzdinės medžiagos režimą, praleiskite frame_images. Pavyzdinių vaizdo įrašų kainos nustatyti negalima.
model: Tipas: string · bytedance/seedance-2.0-fast
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, duration |
Parametrasmaterial_types | Specifikacijatext, image, audio |
Parametrasadditional_properties | Specifikacijafalse |
Parametrasoptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Gyvavimo ciklas: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Apskaitos vienetas | Apmokestinimo sąlygos | Mokestis |
|---|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaVaizdo įrašo žetono kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž 1K vaizdo įrašo tokenų | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Išvestis · Vaizdo įrašo žetono kaina · Įvertis tik palyginimui $0.0084 už 1K vaizdo įrašo tokenų Vaizdo įrašo žetonų įkainis yra pagrindinis kainos orientyras. Antraštėse pateikiami kainos už sekundę įverčiai yra atskiri orientyrai, o ne papildomas mokestis. |
| KonfigūracijaVaizdo įrašo žetono kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž 1K vaizdo įrašo tokenų | Apmokestinimo sąlygosįvestis: with_video_input | Mokestis reference · Vaizdo įrašo žetono kaina · Įvertis tik palyginimui $0.00495 už 1K vaizdo įrašo tokenų Vaizdo įrašo žetonų įkainis yra pagrindinis kainos orientyras. Antraštėse pateikiami kainos už sekundę įverčiai yra atskiri orientyrai, o ne papildomas mokestis. |
| KonfigūracijaVaizdo įrašo žetono kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž 1K vaizdo įrašo tokenų | Apmokestinimo sąlygosgarsas: without_audio | Mokestis Išvestis · Vaizdo įrašo žetono kaina · Įvertis tik palyginimui $0.0084 už 1K vaizdo įrašo tokenų Vaizdo įrašo žetonų įkainis yra pagrindinis kainos orientyras. Antraštėse pateikiami kainos už sekundę įverčiai yra atskiri orientyrai, o ne papildomas mokestis. |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.18144 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Informacinio tarifo duomenys
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
Vaizdo įrašo konfigūracijų kainų nuorodos
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaVaizdo įrašo žetono kaina | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Išvestis · Vaizdo įrašo žetono kaina $0.0084 už 1K vaizdo įrašo tokenų Vaizdo įrašo žetonų įkainis yra pagrindinis kainos orientyras. Antraštėse pateikiami kainos už sekundę įverčiai yra atskiri orientyrai, o ne papildomas mokestis. |
| KonfigūracijaVaizdo įrašo žetono kaina | Apmokestinimo sąlygosgarsas: without_audio | Mokestis Išvestis · Vaizdo įrašo žetono kaina $0.0084 už 1K vaizdo įrašo tokenų Vaizdo įrašo žetonų įkainis yra pagrindinis kainos orientyras. Antraštėse pateikiami kainos už sekundę įverčiai yra atskiri orientyrai, o ne papildomas mokestis. |
| KonfigūracijaVaizdo įrašo žetono kaina | Apmokestinimo sąlygosįvestis: with_video_input | Mokestis reference · Vaizdo įrašo žetono kaina $0.00495 už 1K vaizdo įrašo tokenų Vaizdo įrašo žetonų įkainis yra pagrindinis kainos orientyras. Antraštėse pateikiami kainos už sekundę įverčiai yra atskiri orientyrai, o ne papildomas mokestis. |
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
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-fast","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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
pasirašyti jums priklausančio turinio URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Tikrinti užduoties būseną
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
Kito turinio skaitymas
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
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną tikrą jums priklausantį rezultatą ir grąžintus išmatuotus jo metaduomenis.
Jei reikia patikrinti pradinį atsakymą
503 result_pending_check + pradinis id + X-Should-Retry:false; niekada nekartokite pradinės užklausos
Atsakymo laukai
| Laukas | Tipas | Reikšmė |
|---|---|---|
Laukasindex | Tipasinteger | ReikšmėŠio vaizdo įrašo pozicija rezultatų sąraše, skaičiuojama nuo nulio. |
Laukascontent_url | Tipasstring | ReikšmėPasirašytas HTTPS atsisiuntimo URL šiam užbaigtam vaizdo įrašui. |
Laukassha256 | Tipasstring | null | ReikšmėPradinio vaizdo įrašo baitų SHA-256 santrauka; null, jei nepasiekiama. |
Laukassize_bytes | Tipasinteger | null | ReikšmėPradinio vaizdo įrašo failo dydis baitais; null, jei nepasiekiamas. |
Laukasduration_ms | Tipasinteger | null | ReikšmėIšmatuota vaizdo įrašo trukmė milisekundėmis; null, jei nepasiekiama. |
Laukaswidth | Tipasinteger | null | ReikšmėVaizdo įrašo plotis pikseliais; null, jei nepasiekiamas. |
Laukasheight | Tipasinteger | null | ReikšmėVaizdo įrašo aukštis pikseliais; null, jei nepasiekiamas. |
Laukasvideo_codec | Tipasstring | null | ReikšmėVaizdo kodeko identifikatorius; null, jei neužregistruotas. |
Laukashas_audio | Tipasboolean | null | ReikšmėAr vaizdo įraše yra garso takelis; null, jei nenustatyta. |
Laukasaudio_codec | Tipasstring | null | ReikšmėGarso kodeko identifikatorius; null, kai identifikatorius neužregistruotas. |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas404 · not_found_error | SąlygaPrieiga prie vaizdo įrašo nepasiekiama arba šis vaizdo įrašo ID nerastas. | Kitas žingsnisPatikrinkite prieigą prie vaizdo įrašo. Jei vaizdo įrašas jau yra, naudokite jo pradinį viešą ID ir tą patį API raktą. |
Atsakymas401 · authentication_error | SąlygaAPI raktas neatitinka autentifikuotos paskyros. | Kitas žingsnisPrieš pateikdami patikrinkite savo API raktą ir paskyros prieigą. |
Atsakymas400 · invalid_request_error | SąlygaNepavyko nuskaityti užklausos arba atsisiuntimo indeksas netinkamas. | Kitas žingsnisPataisykite užklausos turinį. Atsisiuntimui pasirinkite išvesties indeksą, kurį grąžino pradinė užduotis. |
Atsakymas422 · price_unavailable | SąlygaPasirinktos vaizdo įrašo konfigūracijos kainos nustatyti negalima. | Kitas žingsnisPasirinkite palaikomą vaizdo įrašo konfigūraciją ir prieš pateikdami pataisytą užklausą užpildykite jos privalomas parinktis. |
Atsakymas422 · invalid_request_error | SąlygaVaizdo įrašo įvestis arba pradinė tęsinio užduotis netinkama. | Kitas žingsnisNaudokite tinkamą HTTPS įvestį. Tęsiniui naudokite užbaigto pradinio vaizdo įrašo viešą ID ir tą patį API raktą. |
Atsakymas402 · billing_error | SąlygaTurimas likutis arba limitai neleidžia rezervuoti lėšų. | Kitas žingsnisPrieš siųsdami naują užklausą patikrinkite turimą likutį ir limitus. |
Atsakymas503 · server_error | SąlygaVaizdo įrašo patikra, saugykla arba prieiga prie paslaugos laikinai nepasiekiama. | Kitas žingsnisPalaukite, kol paslauga taps pasiekiama. Jei jau turite vaizdo įrašo ID, tikrinkite tą pradinę užduotį, užuot pradėję kitą generavimą. |
Atsakymas503 · result_pending_check | SąlygaReikia patikrinti pradinį vaizdo įrašo rezultatą ir mokestį. | Kitas žingsnisIšsaugokite grąžintą vaizdo įrašo ID ir tikrinkite tą užduotį. Kol ji tikrinama, nesiųskite ją pakeičiančios generavimo užklausos. |
Atsakymas503 · owned_result_unavailable | SąlygaEsamo vaizdo įrašo atsisiuntimas laikinai nepasiekiamas. | Kitas žingsnisVėliau patikrinkite tą pačią vaizdo įrašo užduotį ir atsisiųskite jos esamą rezultatą. Naujas generavimas sukuria atskirą operaciją. |
Atsakymas409 · video_not_ready | SąlygaVaizdo įrašo turinys nepaskelbtas. | Kitas žingsnisPatikrinkite pradinės užduoties būseną. Atsisiųskite, kai ji praneša completed; jei praneša failed, vadovaukitės jos pranešimu apie mokesčio patikrą. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra bytedance/seedance-2.0-fast
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · ByteDance: Seedance 2.0 Fast
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·bytedance/seedance-2.0-fast:text,image,audio→video- Kokius laukus naudoja užklausa?
POST /v1/videos·bytedance/seedance-2.0-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Kokie apribojimai taikomi?
POST /v1/videos·bytedance/seedance-2.0-fast:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807