Parametri
Vsak model ohrani svoja izvorna imena parametrov, vsaka stran modela pa jih tudi navaja. Poleg tega API sprejema kanonična imena za parametre, ki imajo v vseh modelih enak pomen, zato koda, napisana za en model, deluje tudi pri naslednjem z manj spremembami.
Kanonična imena
| Kanonično ime | Pomen | Običajna izvorna imena |
|---|---|---|
image |
Vhodna slika ali slika prvega kadra | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Slika zadnjega kadra | end_image_url, last_frame_url, tail_image_url |
images |
Seznam referenčnih slik | image_urls, reference_image_urls |
video |
Vhodni videoposnetek | video_url |
videos |
Seznam referenčnih videoposnetkov | video_urls |
audio |
Vhodni zvok | audio_url |
audios |
Seznam referenčnih zvočnih posnetkov | audio_urls |
mask |
Maska slike | mask_url |
num_outputs |
Število rezultatov za ustvarjanje | num_images |
generate_audio |
Ustvari zvok z videoposnetkom | generate_audio_switch, enable_audio |
Na katero izvorno polje se kanonično ime preslika v vsakem trenutnem modelu:
| Kanonično ime | Izvorno polje (modeli, ki ga uporabljajo) |
|---|---|
audio |
audio_url (modelov: 126) |
audios |
audio_urls (modelov: 7), reference_audio_urls (modelov: 1) |
end_image |
end_image_url (modelov: 76), last_frame_url (modelov: 12), tail_image_url (modelov: 1) |
generate_audio |
generate_audio_switch (modelov: 16), audio (modelov: 3) |
image |
image_url (modelov: 529), start_image_url (modelov: 20), first_frame_url (modelov: 12), first_image_url (modelov: 7), source_image_url (modelov: 2) |
images |
image_urls (modelov: 148), reference_image_urls (modelov: 31) |
mask |
mask_url (modelov: 46) |
num_outputs |
num_images (modelov: 337) |
video |
video_url (modelov: 197) |
videos |
video_urls (modelov: 13), reference_video_urls (modelov: 1) |
Pravila:
- Pošljite kanonično ali izvorno ime. Če pošljete obe imeni z različnima vrednostma, klic ne uspe z
422 invalid_inputza kanonično ime. - Parameter, ki ni niti izvorno niti kanonično ime modela, je zavrnjen z
422 invalid_input(»Unknown parameter«), skupaj s predlogom najbližjega veljavnega imena. Tipkarske napake nikoli ne ostanejo neopažene. - Vsaka stran modela prikazuje obe imeni drugo ob drugem.
Pretvorba tipov
Vrednosti se pretvorijo v tip, ki ga pričakuje model, zato delujejo vsi ti primeri:
| Pošljete | Model pričakuje | Rezultat |
|---|---|---|
5, "5", "5s" |
duration kot niz, na primer "5" |
"5" |
"8" |
celo število | 8 |
"1080P", "4K" |
resolution, na primer "1080p", "4k" |
natančen dovoljeni zapis |
"true", "false", 1, 0 |
logična vrednost | true, false |
"https://…/a.jpg" |
seznam URL-jev | ["https://…/a.jpg"] |
42 |
niz | "42" |
Dovoljene vrednosti se najpre primerjajo natančno, nato brez upoštevanja velikosti črk in nazadnje kot števila (5 se ujema z vrednostmi
"5", "5s" in v slogu "5 s").
Privzete vrednosti
Parametri, ki jih izpustite, uporabijo privzeto vrednost modela, navedeno v tabeli parametrov modela. Cena se
izračuna z enakimi privzetimi vrednostmi (na primer model videoposnetkov, pri katerem je generate_audio privzeto
true, se obračuna z zvokom, razen če pošljete "generate_audio": false).
Datotečni parametri
Parametri za slike, videoposnetke in zvok sprejemajo javni URL, data: URI do velikosti 10 MB ali file_url naložene datoteke.
Glejte Datoteke.