Aqbeż għall-kontenut
Gwida tal-API

Parametri

Ara bħala Markdown Aġġornat

Kull mudell iżomm l-ismijiet nattivi tal-parametri tiegħu, u kull paġna tal-mudell telenkahom. Barra minn hekk, l-API taċċetta ismijiet kanoniċi għall-parametri li jfissru l-istess ħaġa fuq kull mudell, sabiex il-kodiċi miktub għal mudell wieħed jaħdem mal-mudell li jmiss b’inqas bidliet.

Ismijiet kanoniċi

Isem kanoniku Tifsira Ismijiet nattivi tipiċi
image L-immaġni tal-input jew tal-ewwel frejm image_url, start_image_url, first_frame_url, first_image_url, source_image_url
end_image L-immaġni tal-aħħar frejm end_image_url, last_frame_url, tail_image_url
images Lista ta’ immaġnijiet ta’ referenza image_urls, reference_image_urls
video Il-vidjo tal-input video_url
videos Lista ta’ vidjos ta’ referenza video_urls
audio L-awdjo tal-input audio_url
audios Lista ta’ klipps tal-awdjo ta’ referenza audio_urls
mask Immaġni maskra mask_url
num_outputs Kemm għandhom jiġu ġġenerati riżultati num_images
generate_audio Iġġenera ħoss mal-vidjo generate_audio_switch, enable_audio

Liema qasam nattiv jiġi mmappjat ma’ isem kanoniku fuq kull mudell attwali:

Isem kanoniku Qasam nattiv (mudelli li jużawh)
audio audio_url (mudelli: 126)
audios audio_urls (mudelli: 7), reference_audio_urls (mudelli: 1)
end_image end_image_url (mudelli: 76), last_frame_url (mudelli: 12), tail_image_url (mudelli: 1)
generate_audio generate_audio_switch (mudelli: 16), audio (mudelli: 3)
image image_url (mudelli: 529), start_image_url (mudelli: 20), first_frame_url (mudelli: 12), first_image_url (mudelli: 7), source_image_url (mudelli: 2)
images image_urls (mudelli: 148), reference_image_urls (mudelli: 31)
mask mask_url (mudelli: 46)
num_outputs num_images (mudelli: 337)
video video_url (mudelli: 197)
videos video_urls (mudelli: 13), reference_video_urls (mudelli: 1)

Regoli:

  • Ibgħat jew l-isem kanoniku jew dak nattiv. Jekk tibgħat it-tnejn b’valuri differenti, is-sejħa tfalli bi 422 invalid_input fuq l-isem kanoniku.
  • Parametru li la huwa isem nattiv u lanqas isem kanoniku tal-mudell jiġi rrifjutat bi 422 invalid_input ("Parametru mhux magħruf"), bl-eqreb isem validu bħala suġġeriment. Żbalji fit-tajpjar qatt ma jgħaddu mingħajr avviż.
  • Kull paġna tal-mudell turi ż-żewġ ismijiet ħdejn xulxin.

Konverżjoni tat-tip

Il-valuri jiġu kkonvertiti għat-tip li jistenna l-mudell, għalhekk dawn kollha jaħdmu:

Int tibgħat Il-mudell jistenna Isir
5, "5", "5s" duration bħala string bħal "5" "5"
"8" numru sħiħ 8
"1080P", "4K" resolution bħal "1080p", "4k" l-ortografija eżatta permessa
"true", "false", 1, 0 valur Boolean true, false
"https://…/a.jpg" lista ta’ URLs ["https://…/a.jpg"]
42 string "42"

Il-valuri permessi jiġu mqabbla l-ewwel eżattament, imbagħad mingħajr ma jitqiesu l-ittri kbar u żgħar, u mbagħad bħala numri (5 jaqbel ma’ "5", "5s" u valuri fl-istil ta’ "5 s").

Valuri prestabbiliti

Il-parametri li tħalli barra jużaw il-valur prestabbilit tal-mudell, li huwa elenkat fit-tabella tal-parametri tal-mudell. Il-prezz jiġi kkalkulat bl-istess valuri prestabbiliti (pereżempju, mudell tal-vidjo li l-valur prestabbilit ta’ generate_audio tiegħu huwa true jiġi pprezzat bil-ħoss sakemm ma tibgħatx "generate_audio": false).

Parametri tal-fajls

Il-parametri tal-immaġni, tal-vidjo u tal-awdjo jaċċettaw URL pubbliku, URI data: sa 10 MB, jew file_url ta’ upload. Ara Fajls.