Parametry
Každý model zachovává své nativní názvy parametrů a každá stránka modelu je uvádí. Kromě toho API přijímá kanonické názvy parametrů, které mají ve všech modelech stejný význam, takže kód napsaný pro jeden model funguje i pro další model s menším počtem změn.
Kanonické názvy
| Kanonický název | Význam | Typické nativní názvy |
|---|---|---|
image |
Vstupní obrázek nebo obrázek prvního snímku | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Obrázek posledního snímku | end_image_url, last_frame_url, tail_image_url |
images |
Seznam referenčních obrázků | image_urls, reference_image_urls |
video |
Vstupní video | video_url |
videos |
Seznam referenčních videí | video_urls |
audio |
Vstupní zvuk | audio_url |
audios |
Seznam referenčních zvukových klipů | audio_urls |
mask |
Obrázek masky | mask_url |
num_outputs |
Kolik výsledků vygenerovat | num_images |
generate_audio |
Generovat zvuk společně s videem | generate_audio_switch, enable_audio |
Na které nativní pole se kanonický název mapuje v každém aktuálním modelu:
| Kanonický název | Nativní pole (modely, které ho používají) |
|---|---|
audio |
audio_url (modelů: 126) |
audios |
audio_urls (modelů: 7), reference_audio_urls (modelů: 1) |
end_image |
end_image_url (modelů: 76), last_frame_url (modelů: 12), tail_image_url (modelů: 1) |
generate_audio |
generate_audio_switch (modelů: 16), audio (modelů: 3) |
image |
image_url (modelů: 529), start_image_url (modelů: 20), first_frame_url (modelů: 12), first_image_url (modelů: 7), source_image_url (modelů: 2) |
images |
image_urls (modelů: 148), reference_image_urls (modelů: 31) |
mask |
mask_url (modelů: 46) |
num_outputs |
num_images (modelů: 337) |
video |
video_url (modelů: 197) |
videos |
video_urls (modelů: 13), reference_video_urls (modelů: 1) |
Pravidla:
- Odešlete buď kanonický název, nebo nativní název. Pokud odešlete oba s různými hodnotami, volání selže s
422 invalid_inputu kanonického názvu. - Parametr, který není nativním ani kanonickým názvem modelu, je odmítnut s
422 invalid_input("Unknown parameter") a jako návrh je uveden nejbližší platný název. Překlepy nikdy neprojdou bez upozornění. - Každá stránka modelu zobrazuje oba názvy vedle sebe.
Převod typů
Hodnoty se převádějí na typ očekávaný modelem, takže fungují všechny tyto varianty:
| Odešlete | Model očekává | Výsledek |
|---|---|---|
5, "5", "5s" |
duration jako řetězec, například "5" |
"5" |
"8" |
celé číslo | 8 |
"1080P", "4K" |
resolution, například "1080p", "4k" |
přesný povolený zápis |
"true", "false", 1, 0 |
logická hodnota | true, false |
"https://…/a.jpg" |
seznam URL | ["https://…/a.jpg"] |
42 |
řetězec | "42" |
Povolené hodnoty se nejprve porovnávají přesně, poté bez ohledu na velikost písmen a nakonec jako čísla (5 odpovídá
hodnotám ve stylu "5", "5s" a "5 s").
Výchozí hodnoty
Parametry, které vynecháte, použijí výchozí hodnotu modelu uvedenou v tabulce parametrů modelu. Cena se
vypočítává se stejnými výchozími hodnotami (například video model, jehož generate_audio má výchozí hodnotu true,
je oceněn včetně zvuku, pokud neodešlete "generate_audio": false).
Parametry souborů
Parametry obrázků, videí a zvuku přijímají veřejnou URL, URI data: o velikosti až 10 MB nebo hodnotu file_url nahraného souboru.
Viz Files.