ByteDance: Seedance 2.0 Mini
Seedance 2.0 Mini kuria trumpus vaizdo įrašus su pasirenkamu generuojamu garsu iš teksto, vaizdų, vaizdo ir garso etalonų. Jis palaiko scenų kūrimą, tikslinį vaizdo redagavimą ir tęsimą su dokumentuotu 480p arba 720p išvesties profiliu.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Seedance 2.0 Mini yra atskirai pavadintas ByteDance Seedance 2.0 audiovizualinės šeimos modelis. Gamintojas dokumentuoja vaizdo kūrimą iš teksto, vaizdo kūrimą iš pirmojo kadro arba iš pirmojo ir paskutiniojo kadrų, daugiarūšį generavimą pagal etalonus, vaizdo redagavimą ir pratęsimą. Garsą galima generuoti kartu su vaizdu. Kūrybos režimą pasirinkite pagal jau turimą medžiagą: rašytinę užduotį, fiksuotą pradinį vaizdą, du ribinius kadrus ar klipą, kuriam reikia taisymo arba tęsinio.
Mini turi savą išvesties profilį. Gamintojas nurodo 480p ir 720p vaizdą su 8 bitų spalva, 24 kadrais per sekundę bei MP4 išvestimi. Palaikomi kraštinių santykiai yra 21:9, 16:9, 4:3, 1:1, 3:4 ir 9:16; dokumentuota generavimo trukmė – 4–15 sekundžių. Gamintojo trukmės valdiklis taip pat leidžia automatinį pasirinkimą šiame intervale. Pilno Seedance 2.0 modelio 1080p ir 4K parinktys atskiros; jos nėra Mini nustatymai. Šeimos galimybių lentelėje nurodomas paskutinio sugeneruoto kadro grąžinimas, o Draft režimas nepalaikomas.
Omni etalonų režimas kuria naują sceną naudodamas pasirinktą informaciją iš pateiktos medžiagos. Vaizdas gali apibrėžti subjekto išvaizdą, kompoziciją ar vizualinį perteikimą. Vaizdo įrašas gali nustatyti veiksmą, kameros judėjimą ar efektą; garso etalonas – balso tembrą, melodiją ar sakytinį turinį. Pasakykite modeliui, ką perimti iš kiekvieno etalono, užuot prašę kopijuoti visas savybes. Pavyzdžiui, produkto nuotrauką naudokite formai ir spalvai, trumpą kameros judėjimo klipą – priartėjimui, o garso etaloną – atmosferai.
Šeimos procesas leidžia iki devynių etaloninių vaizdų, trijų vaizdo klipų ir trijų garso klipų. Vaizdo etalonai trunka po 2–15 sekundžių, iš viso ne daugiau nei 15 sekundžių; garso etalonams taikomos tokios pačios vieno klipo ir bendros trukmės ribos. Vien garsas ir tekstas su garsu be vaizdinio etalono nėra palaikomi etalonų deriniai. Kūryba vien iš teksto yra atskiras palaikomas režimas. Sekai išteklius pateikite numatyta tvarka ir nuosekliai vadinkite juos Image 1, Video 1 ar Audio 1, naudodami tvarką kiekvieno medijos tipo viduje. Rašytinėje užklausoje ištekliaus identifikatoriumi nepakeiskite numeruotos nuorodos.
Pirmojo kadro vaizdas apibrėžia vaizdu grindžiamo kadro pradžią. Pirmojo ir paskutiniojo kadrų režimas apibrėžia abi ribas. Jei svarbūs tiksliai šie ribiniai vaizdai, pasirinkite specialų režimą, užuot omni etalonų užklausoje etalonus aprašę kaip pradžią ir pabaigą. Pastarasis yra tekstine instrukcija nukreipiamas efektas ir nėra lygiavertis griežtam ribinių kadrų pasirinkimui. Vaizdus paruoškite išvesties kompozicijai ir nurodykite veiksmą, jungiantį pradžios bei pabaigos situacijas.
Vaizdo redagavimas keičia esamą klipą, užuot jį naudojęs tik kaip įkvėpimą. Nurodykite redaguojamą vaizdo įrašą, keičiamą objektą ar sritį, jo pasirodymo laiką bei vietą ir išsaugotinas detales. Naudinga užduotis: „Video 1 pakeiskite puodelį indu, parodytu Image 1; išsaugokite rankos judesį, kadravimą, apšvietimą ir stalo išdėstymą.“ Šalinimui įvardykite nepageidaujamą objektą ir aplinkinius elementus, kurie turi likti. Kūrėjas pataria redagavimui ar pratęsimui tiesiogiai nurodyti tikslinį vaizdo įrašą; pavadinus jį etalonu galima vietoj to perteikti prašymą sukurti naują sceną.
Vaizdo pratęsimas prideda įvykius prieš esamą klipą arba po jo. Aprašykite tęsimo kryptį ir tai, kas vyksta vėliau ar anksčiau. Dokumentuotas procesas taip pat gali sujungti du ar tris klipus sugeneruotais perėjimais; trys įvesties vaizdo įrašai kartu vis tiek telpa į 15 sekundžių etalonų biudžetą. Mokomoji medžiaga skiria tęsinį, daugiausia apimantį originalaus klipo ribinę medžiagą, nuo prašymo, aiškiai išsaugančio originalų turinį. Nurodykite norimą rezultato sudėtį: tik tęsinys ar scena, apimanti pateiktą klipą ir naują veiksmą.
Aiškiam režisavimui atskirkite stabilų scenos aprašą nuo įvykių sekos. Kiekvieną subjektą apibrėžkite dviem ar trimis skiriamaisiais vizualiniais bruožais ir nuoseklia žyma. Tada aprašykite veiksmus, aplinką, apšvietimą, kameros judėjimą, vizualinį stilių bei apribojimus. Dialoge kiekvieną frazę susiekite su jos kalbėtoju ir atitinkamu veiksmu. Naudokite nuoseklias kadrų žymas, užuot tikslias laiko žymas laikę patikimais valdikliais: kūrėjas pažymi, kad tikslus laikas gali būti nestabilus. Pastatyto produkto užduotis galėtų skambėti taip: „Image 1 apibrėžia Product A. Shot 1: lėtai artėkite prie Product A ant stalviršio. Shot 2: ranka pasuka jį į šviesą. Shot 3: sustokite ties priekine etikete. Švelni kambario atmosfera; išsaugokite atspausdintus užrašus.“
Etalonus paruoškite pagal dokumentuotas šeimos įvesties taisykles. Palaikomi vaizdų formatai apima JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ir HEIF; kiekvienas vaizdas mažesnis nei 30 MB. Vadovas nurodo vaizdo plotį ir aukštį griežtai tarp 300 ir 6 000 pikselių bei kraštinių santykį griežtai tarp 0.4 ir 2.5. Vaizdo etalonai naudoja MP4 arba MOV su H.264 ar H.265 vaizdu ir AAC ar MP3 garsu, kiekvienas yra ne didesnis nei 200 MB ir turi 24–60 kadrų per sekundę. Jų plotis ir aukštis yra 300–6 000 pikselių, kraštinių santykis 0.4–2.5, o bendras pikselių skaičius 407 696–8 295 044. Garso etalonai naudoja WAV arba MP3 ir yra ne didesni nei 15 MB kiekvienas. Tai gamintojo įvesties paruošimo specifikacijos, atskiros nuo konkrečios programos įkėlimo valdiklių.
Kūrėjo portretų procesas reikalauja specialaus vaizdų ar vaizdo įrašų su tikrais žmonių veidais paruošimo: tiesioginis etalonų įkėlimas nėra standartinis palaikomas kelias. Kaip atskirus sprendimus jis dokumentuoja patikimas modelių išvestis, iš anksto nustatytus skaitmeninius veikėjus ir autorizuotą tikro asmens išteklių procesą. Taip pat reikia patikrinti balso atitikimą, tarimą ir garsą ties klipo riba. Užklausų vadovas rekomenduoja aprašyti numatytas balso savybes ir dialogo stilių laikyti artimą garso etalonui. Galutiniame rezultate patikrinkite subjekto nuoseklumą, tikslius sakytinius žodžius, veiksmų laiką, kadrų perėjimus ir pabaigos garsą; patobulinkite konkretų nuo užduoties besiskiriantį elementą.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos bytedance/seedance-2.0-mini
bytedance/seedance-2.0-miniPradžia
Seedance 2.0 Mini kuria trumpus vaizdo įrašus su pasirenkamu generuojamu garsu iš teksto, vaizdų, vaizdo ir garso etalonų. Jis palaiko scenų kūrimą, tikslinį vaizdo redagavimą ir tęsimą su dokumentuotu 480p arba 720p išvesties profiliu.
- 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-mini | 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-mini
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-mini
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-mini
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.007 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.0042 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.007 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.1512 į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.007 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.007 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.0042 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-mini","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-mini
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · ByteDance: Seedance 2.0 Mini
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·bytedance/seedance-2.0-mini:text,image,audio→video- Kokius laukus naudoja užklausa?
POST /v1/videos·bytedance/seedance-2.0-mini: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-mini:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807