Parametri
Svaki model zadržava svoje izvorne nazive parametara, a svaka stranica modela navodi ih. Osim toga, API prihvaća kanonske nazive za parametre koji imaju isto značenje na svakom modelu, pa kod napisan za jedan model funkcionira i za sljedeći uz manje izmjena.
Kanonski nazivi
| Kanonski naziv | Značenje | Uobičajeni izvorni nazivi |
|---|---|---|
image |
Ulazna slika ili slika prvog kadra | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Slika posljednjeg kadra | end_image_url, last_frame_url, tail_image_url |
images |
Popis referentnih slika | image_urls, reference_image_urls |
video |
Ulazni videozapis | video_url |
videos |
Popis referentnih videozapisa | video_urls |
audio |
Ulazni zvuk | audio_url |
audios |
Popis referentnih zvučnih isječaka | audio_urls |
mask |
Slikovna maska | mask_url |
num_outputs |
Broj rezultata koje treba generirati | num_images |
generate_audio |
Generiranje zvuka uz videozapis | generate_audio_switch, enable_audio |
Na koje se izvorno polje kanonski naziv preslikava u svakom trenutačnom modelu:
| Kanonski naziv | Izvorno polje (modeli koji ga koriste) |
|---|---|
audio |
audio_url (modela: 126) |
audios |
audio_urls (modela: 7), reference_audio_urls (modela: 1) |
end_image |
end_image_url (modela: 76), last_frame_url (modela: 12), tail_image_url (modela: 1) |
generate_audio |
generate_audio_switch (modela: 16), audio (modela: 3) |
image |
image_url (modela: 529), start_image_url (modela: 20), first_frame_url (modela: 12), first_image_url (modela: 7), source_image_url (modela: 2) |
images |
image_urls (modela: 148), reference_image_urls (modela: 31) |
mask |
mask_url (modela: 46) |
num_outputs |
num_images (modela: 337) |
video |
video_url (modela: 197) |
videos |
video_urls (modela: 13), reference_video_urls (modela: 1) |
Pravila:
- Pošaljite kanonski ili izvorni naziv. Ako pošaljete oba s različitim vrijednostima, poziv neće uspjeti s
422 invalid_inputna kanonskom nazivu. - Parametar koji nije ni izvorni ni kanonski naziv modela odbija se s
422 invalid_input("Nepoznati parametar"), uz prijedlog najbližeg valjanog naziva. Tipfeleri nikad ne prolaze neprimijećeno. - Svaka stranica modela prikazuje oba naziva jedan uz drugi.
Prisilna konverzija tipova
Vrijednosti se pretvaraju u tip koji model očekuje, pa svi ovi primjeri funkcioniraju:
| Šaljete | Model očekuje | Postaje |
|---|---|---|
5, "5", "5s" |
duration kao niz znakova, primjerice "5" |
"5" |
"8" |
cijeli broj | 8 |
"1080P", "4K" |
resolution, primjerice "1080p", "4k" |
točan dopušteni zapis |
"true", "false", 1, 0 |
Booleova vrijednost | true, false |
"https://…/a.jpg" |
popis URL-ova | ["https://…/a.jpg"] |
42 |
niz znakova | "42" |
Dopuštene vrijednosti najprije se uspoređuju potpuno jednako, zatim bez obzira na velika i mala slova, a potom kao brojevi (5 odgovara vrijednostima "5", "5s" i oblika
"5 s").
Zadane vrijednosti
Parametri koje izostavite koriste zadanu vrijednost modela, navedenu u tablici parametara modela. Cijena se
izračunava s istim zadanim vrijednostima (na primjer, model videozapisa čiji je zadani generate_audio postavljen na
true obračunava se sa zvukom ako ne pošaljete "generate_audio": false).
Datotečni parametri
Parametri za slike, videozapise i zvuk prihvaćaju javni URL, data: URI veličine do 10 MB ili file_url prenesene datoteke.
Pogledajte Datoteke.