Parametrai
Kiekvienas modelis išsaugo savo vietinius parametrų pavadinimus, o kiekviename modelio puslapyje jie pateikiami. Be to, API priima kanoninius pavadinimus parametrams, kurie visuose modeliuose reiškia tą patį, todėl vienam modeliui parašytas kodas veikia ir su kitu, atliekant mažiau pakeitimų.
Kanoniniai pavadinimai
| Kanoninis pavadinimas | Reikšmė | Įprasti vietiniai pavadinimai |
|---|---|---|
image |
Įvesties arba pirmojo kadro vaizdas | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Paskutinio kadro vaizdas | end_image_url, last_frame_url, tail_image_url |
images |
Etaloninių vaizdų sąrašas | image_urls, reference_image_urls |
video |
Įvesties vaizdo įrašas | video_url |
videos |
Etaloninių vaizdo įrašų sąrašas | video_urls |
audio |
Įvesties garsas | audio_url |
audios |
Etaloninių garso įrašų sąrašas | audio_urls |
mask |
Kaukės vaizdas | mask_url |
num_outputs |
Kiek rezultatų sugeneruoti | num_images |
generate_audio |
Generuoti garsą kartu su vaizdo įrašu | generate_audio_switch, enable_audio |
Į kurį vietinį lauką kiekviename dabartiniame modelyje susiejamas kanoninis pavadinimas:
| Kanoninis pavadinimas | Gimtasis laukas (jį naudojantys modeliai) |
|---|---|
audio |
audio_url (modelių: 126) |
audios |
audio_urls (modelių: 7), reference_audio_urls (modelių: 1) |
end_image |
end_image_url (modelių: 76), last_frame_url (modelių: 12), tail_image_url (modelių: 1) |
generate_audio |
generate_audio_switch (modelių: 16), audio (modelių: 3) |
image |
image_url (modelių: 529), start_image_url (modelių: 20), first_frame_url (modelių: 12), first_image_url (modelių: 7), source_image_url (modelių: 2) |
images |
image_urls (modelių: 148), reference_image_urls (modelių: 31) |
mask |
mask_url (modelių: 46) |
num_outputs |
num_images (modelių: 337) |
video |
video_url (modelių: 197) |
videos |
video_urls (modelių: 13), reference_video_urls (modelių: 1) |
Taisyklės:
- Siųskite arba kanoninį pavadinimą, arba vietinį. Jei siunčiate abu su skirtingomis reikšmėmis, iškvietimas nepavyksta su
422 invalid_inputkanoniniam pavadinimui. - Parametras, kuris nėra nei vietinis, nei kanoninis modelio pavadinimas, atmetamas su
422 invalid_input("Unknown parameter"), kartu pateikiant artimiausią tinkamą pavadinimą kaip pasiūlymą. Rašybos klaidos niekada nepraleidžiamos nepastebėtos. - Kiekviename modelio puslapyje abu pavadinimai rodomi greta.
Tipų konvertavimas
Reikšmės konvertuojamos į modelio laukiamą tipą, todėl veikia visi šie variantai:
| Siunčiate | Modelis tikisi | Tampa |
|---|---|---|
5, "5", "5s" |
duration kaip eilutės, pvz., "5" |
"5" |
"8" |
sveikojo skaičiaus | 8 |
"1080P", "4K" |
resolution, pvz., "1080p", "4k" |
tikslus leidžiamas rašybos variantas |
"true", "false", 1, 0 |
loginės reikšmės | true, false |
"https://…/a.jpg" |
URL sąrašo | ["https://…/a.jpg"] |
42 |
eilutės | "42" |
Pirmiausia leidžiamos reikšmės sutapatinamos tiksliai, tada neatsižvelgiant į raidžių registrą, o galiausiai kaip skaičiai (5 sutampa su "5", "5s" ir
"5 s" tipo reikšmėmis).
Numatytoji reikšmė
Nepateikti parametrai naudoja modelio numatytąsias reikšmes, kurios nurodytos modelio parametrų lentelėje. Kaina
apskaičiuojama naudojant tas pačias numatytąsias reikšmes (pavyzdžiui, vaizdo įrašų modelio, kurio generate_audio numatytoji reikšmė yra true, kaina skaičiuojama
su garsu, nebent siunčiate "generate_audio": false).
Failų parametrai
Vaizdo, vaizdo įrašų ir garso parametrai priima viešą URL, ne didesnį nei 10 MB data: URI arba įkelto failo file_url.
Žr. Failai.