Black Forest Labs: FLUX.3 Video
FLUX 3 Video kuria klipus su sinchronizuotu dialogu, efektais ir atmosfera iš teksto, fiksuotų vaizdų ar tęsiamo klipo. Pagrindiniai kadrai, kelių kadrų kompozicija ir peržiūros gerinimas padeda išplėtoti valdomą seką bei išsaugoti pasirinktą atlikimą.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
FLUX 3 Video yra daugiarūšis Black Forest Labs modelis vaizdo įrašams su sinchronizuotu garsu generuoti. Jis kuria scenas iš tekstinės užduoties, plėtoja judėjimą aplink fiksuotus vaizdus arba tęsia esamą klipą. Kalbą, efektus ir atmosferą galima generuoti kartu su kadrais, palaikant trumpą sceną, kurios kameros judėjimas, veiksmas bei garsas suplanuoti kaip viena seka.
Vaizdo kūrimui iš teksto aprašykite subjektą, aplinką, matomą veiksmą, kameros elgseną ir garsą. Naudinga produkto scena gali prasidėti bendru vaizdu, judėti link medžiagos detalės ir baigtis naudojamu produktu. Kelių kadrų užduotys gali įvardyti kiekvieną kadrą ir perėjimą tarp kameros kampų, išlaikydamos subjektą bei vizualinį stilių nuoseklius visoje sekoje. Scenoje gali atsirasti tipografika, todėl pateikite tikslius žodžius ir jų vietą, kai svarbus ženklas ar pavadinimas. Modelis apima gyvo veiksmo filmavimą, animaciją, judesio grafiką ir stilizuotą išvaizdą.
Vaizdo kūrimas iš vaizdų naudoja nuo vieno iki dešimties pagrindinių kadrų vaizdų. Vienas vaizdas nustato pradinį kadrą; pora fiksuoja pradžią ir pabaigą, o surikiuoti vaizdai su laiko žymomis nukreipia konkrečius klipo momentus. Šie vaizdai tampa vaizdo įrašo kadrais, o ne tarnauja vien kaip bendrieji stiliaus etalonai. Kai yra trys ar daugiau vaizdų be laiko žymų, gamintojas reikalauja aiškios trukmės: pirmasis ir paskutinysis fiksuoja galinius taškus, o kiti išdėstomi tolygiai tarp jų. Kadrai su laiko žymomis turi būti laiko tvarka; automatinė trukmė tęsiasi iki paskutinės laiko žymos, suapvalintos aukštyn, neviršijant 20 sekundžių ribos. Pagrindinius kadrus paruoškite su suderinamais subjektais, kadravimu ir vizualinėmis detalėmis, tada aprašykite judėjimą tarp jų. Produkto atskleidimui pirmasis kadras gali rodyti uždarytą objektą, o paskutinysis – atidarytą išdėstymą, tarp jų vykstantį veiksmą apibrėžiant užklausoje.
Vaizdo tęsinys prasideda nuo pateikto klipo paskutinių kadrų. Pristatymo procesas naudoja iki keturių sekundžių esamo vaizdo ir garso kaip kontekstą kitam veiksmui, perkeldamas kameros elgseną, judėjimą bei garsą per sujungimą. Pasirinkite šaltinio pabaigą, kuri aiškiai nustato, kur juda subjektas ir kamera, ir aprašykite, kas vyksta toliau. Tęsimas skiriasi nuo esamo kadro perrašymo: FLUX Video Edit yra atskiras redagavimo modelis ir netampa generavimo modelio dalimi vien dėl to, kad abu priima vaizdo įrašą.
Tekstu ir vaizdais sąlygojamas generavimas palaiko nuo 5 iki 20 sekundžių klipus. Konkretaus režimo apžvalga vaizdo tęsiniui nurodo 5–15 sekundžių išvesties intervalą. Trukmę ir kraštinių santykį galima pasirinkti automatiškai arba užduotyje nurodyti palaikomą horizontalią, kvadratinę ar vertikalią formą, įskaitant 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 ir 9:21. Išvestis yra 24 kadrai per sekundę. Trukmę rinkitės pagal nedidelį matomų veiksmų skaičių, užuot bandę visą istoriją sutalpinti į vieną trumpą generavimą.
HD išvestis gaunama tiesiogiai iš generavimo; FHD, QHD ir UHD užbaigia tą pačią sceną naudodami vaizdo raiškos didinimo modelį. Esant 16:9, pateikiami matmenys atitinkamai yra 1280 × 704, 1920 × 1088, 2560 × 1440 ir 3840 × 2176. Matmenys derinami prie 32 kartotinių, todėl įvardyta raiškos klasė gali skirtis nuo įprasto pateikimo dydžio. Kai reikia tikslaus standartinio formato, apkirpkite užbaigtą kadrą, išsaugodami svarbų turinį jo kraštuose. Aukštesnė raiška yra užbaigimo žingsnis, o ne kita kadro interpretacija.
Savasis garsas pagal numatytąsias nuostatas įjungtas ir gali būti išjungtas tyliam klipui. Dialogui cituokite frazę, įvardykite kalbėtoją ir aprašykite atlikimą; daugiakalbė kalba, akcentai ir lūpų sinchronizavimas yra modelio garso bei vaizdo galimybių dalis. Dialogą ir garso žymas laikykite susietus su matomu įvykiu, pavyzdžiui, užsidarančiu dangčiu ar tolstančiais žingsniais. Balsą, laiką ir sakytines formuluotes patikrinkite kartu su vaizdu, užuot garsą laikę nesusijusiu sluoksniu, pridėtu po generavimo.
Draft režimas sukuria HD peržiūrą ir Draft paketą. Pasirinktą paketą pagerinkite, kad tą generavimą perteiktumėte pilna kokybe; tos pačios užklausos siuntimas kaip naujos pilno generavimo užklausos yra nauja interpretacija ir gali sukurti kitokį atlikimą. Draft naudoja tik HD, o gerinimas gali pasirinkti keturias raiškos klases ir pagal numatytąsias nuostatas naudoja FHD. Tai suteikia praktinę seką: pirmiausia tyrinėti veiksmą bei kompoziciją, tada pasirinktą atlikimą užbaigti numatytu pateikimo dydžiu.
Gamintojo procesas grąžina užduoties identifikatorių prieš MP4 parengimą, tada pateikia užbaigtą klipą pasibaigus apdorojimui. Pasirašytos rezultatų vietos baigia galioti maždaug po dviejų valandų, todėl pasirinkę kadrą išsaugokite faktinį išteklių. Pagrindinių kadrų perėjimus, montažo kirpimus, tipografiką, subjekto detales ir garso sujungimą patikrinkite pagal užduotį. Ilgesnei sekai sėkmingo kadro etalonus bei pabaigos kontekstą išsaugokite kaip įvestį kitam klipui, užuot manę, kad viena trumpa užklausa apima visą produkciją.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos black-forest-labs/flux-3-video
black-forest-labs/flux-3-video
black-forest-labs/flux-3-videoPradžia
FLUX 3 Video kuria klipus su sinchronizuotu dialogu, efektais ir atmosfera iš teksto, fiksuotų vaizdų ar tęsiamo klipo. Pagrindiniai kadrai, kelių kadrų kompozicija ir peržiūros gerinimas padeda išplėtoti valdomą seką bei išsaugoti pasirinktą atlikimą.
- Leidžiamos įvestys
- Tekstas · Vaizdai
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image- 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 black-forest-labs/flux-3-video | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 Mažiausia reikšmė: 1 Didžiausia reikšmė: 600 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 720p, 1080p | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Numatyta— |
Laukasgenerate_audio | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos false, true | 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 objekte yra type=image_url, image_url su url ir frame_type. Naudokite HTTPS paveikslėlio URL ir nustatykite frame_type reikšmę first_frame arba last_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Tikslūs raktai: type, image_url, frame_type Sąlygos: Šie raktai apibūdina kiekvieną kadro objektą; image_url turi tik url. Jei užklausoje yra tik tekstas, praleiskite frame_images. | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasprevious_job_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Šablonas: ^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ | 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 prompt kaip tekstą ir duration sveikomis sekundėmis. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
model: Tipas: string · black-forest-labs/flux-3-video
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 pirmojo kadro paveikslėlis. · Privaloma: model, prompt, duration, frame_images
frame_images yra masyvas. Kiekviename kadro objekte yra type, image_url ir frame_type; image_url turi url lauką. Nustatykite type reikšmę image_url. Naudokite first_frame ir neprivalomą last_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Kiekvienam kadrui pateikite viešą HTTPS paveikslėlio URL. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
Tikslūs raktai: type, image_url, frame_type
model: Tipas: string · black-forest-labs/flux-3-video
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Continue a video · Tekstinė užklausa ir jūsų užbaigtas pradinis vaizdo įrašas. · Privaloma: model, prompt, duration, previous_job_id
Nustatykite previous_job_id į viešą savo užbaigto pradinio vaizdo įrašo ID. Naudokite tą patį modelį, paskyrą ir API raktą. Išsaugokite esamą užduoties tapatybę; ši užklausa sukuria atskirą tęsinio užduotį. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
model: Tipas: string · black-forest-labs/flux-3-video
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 |
Parametrasadditional_properties | Specifikacijafalse |
Parametrasoptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, previous_job_id, 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 | Mokesčio komponentas | Pavyzdžio režimas | Apskaitos vienetas | Apmokestinimo sąlygos | Mokestis |
|---|---|---|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio režimas— | 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ūracijaTekstas į vaizdo įrašą · Paveikslėlis į vaizdo įrašą (kadrų paveikslėliai) · orientacinis tarifas | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentasreference_output_rate | Pavyzdžio režimasIš teksto į vaizdo įrašą · Iš vaizdo į vaizdo įrašą (kadrų vaizdai) | Apskaitos vienetasuž išvesties sekundę | Apmokestinimo sąlygos— | Mokestis Išvestis · Išvesties vaizdo įrašo sekundės orientacinis tarifas · Įvertis tik palyginimui $0.34 už išvesties sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio režimas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 1080p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.58 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio režimas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 720p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.34 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio režimas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosįvestis: video_continuation; skiriamoji geba: 1080p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $1.06 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio režimas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosįvestis: video_continuation; skiriamoji geba: 720p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.82 už vaizdo įrašo sekundę |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokesčio komponentas— | Pavyzdžio režimas— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $1.7 į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 kaina | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Išvestis · Vaizdo įrašo kaina $0.34 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 720p | Mokestis Išvestis · Vaizdo įrašo kaina $0.34 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 1080p | Mokestis Išvestis · Vaizdo įrašo kaina $0.58 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosįvestis: video_continuation; skiriamoji geba: 720p | Mokestis Išvestis · Vaizdo įrašo kaina $0.82 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosįvestis: video_continuation; skiriamoji geba: 1080p | Mokestis Išvestis · Vaizdo įrašo kaina $1.06 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
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('{"aspect_ratio":"16:9","duration":8,"model":"black-forest-labs/flux-3-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 black-forest-labs/flux-3-video
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Black Forest Labs: FLUX.3 Video
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·black-forest-labs/flux-3-video:text,image→video- Kokius laukus naudoja užklausa?
POST /v1/videos·black-forest-labs/flux-3-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,previous_job_id,callback_url,session_id,trace,user- Kokie apribojimai taikomi?
POST /v1/videos·black-forest-labs/flux-3-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1