Paraméterek
Minden modell megtartja a natív paraméterneveit, és minden modelloldal felsorolja ezeket. Emellett az API elfogad kanonikus neveket azokhoz a paraméterekhez, amelyek minden modellen ugyanazt jelentik, így az egyik modellhez írt kód kevesebb módosítással használható a következő modellen is.
Kanonikus nevek
| Kanonikus név | Jelentés | Tipikus natív nevek |
|---|---|---|
image |
A bemeneti vagy első képkocka képe | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Az utolsó képkocka képe | end_image_url, last_frame_url, tail_image_url |
images |
Referenciaképek listája | image_urls, reference_image_urls |
video |
A bemeneti videó | video_url |
videos |
Referenciavideók listája | video_urls |
audio |
A bemeneti hang | audio_url |
audios |
Referencia-hangklippek listája | audio_urls |
mask |
Maszkkép | mask_url |
num_outputs |
A generálandó eredmények száma | num_images |
generate_audio |
Hang generálása a videóval együtt | generate_audio_switch, enable_audio |
Az egyes aktuális modelleken a kanonikus név által leképezett natív mező:
| Kanonikus név | Natív mező (az ezt használó modellek) |
|---|---|
audio |
audio_url (modellek: 126) |
audios |
audio_urls (modellek: 7), reference_audio_urls (modellek: 1) |
end_image |
end_image_url (modellek: 76), last_frame_url (modellek: 12), tail_image_url (modellek: 1) |
generate_audio |
generate_audio_switch (modellek: 16), audio (modellek: 3) |
image |
image_url (modellek: 529), start_image_url (modellek: 20), first_frame_url (modellek: 12), first_image_url (modellek: 7), source_image_url (modellek: 2) |
images |
image_urls (modellek: 148), reference_image_urls (modellek: 31) |
mask |
mask_url (modellek: 46) |
num_outputs |
num_images (modellek: 337) |
video |
video_url (modellek: 197) |
videos |
video_urls (modellek: 13), reference_video_urls (modellek: 1) |
Szabályok:
- Küldd el vagy a kanonikus nevet, vagy a natív nevet. Ha mindkettőt elküldöd eltérő értékekkel, a hívás meghiúsul a
kanonikus névhez tartozó
422 invalid_inputhibával. - A modell sem natív, sem kanonikus nevének nem megfelelő paraméter elutasításra kerül
422 invalid_inputhibával ("Ismeretlen paraméter"), és a rendszer javaslatként megadja a legközelebbi érvényes nevet. Az elgépelések soha nem mennek át csendben. - Minden modelloldal egymás mellett jeleníti meg mindkét nevet.
Típuskonverzió
Az értékek a modell által elvárt típusra konvertálódnak, ezért az alábbiak mind működnek:
| Ezt küldöd | Ezt várja a modell | Ebből lesz |
|---|---|---|
5, "5", "5s" |
duration stringként, például "5" |
"5" |
"8" |
egész szám | 8 |
"1080P", "4K" |
resolution, például "1080p", "4k" |
a pontosan engedélyezett írásmód |
"true", "false", 1, 0 |
logikai érték | true, false |
"https://…/a.jpg" |
URL-ek listája | ["https://…/a.jpg"] |
42 |
string | "42" |
Az engedélyezett értékeket először pontos egyezéssel, majd a kis- és nagybetűk figyelmen kívül hagyásával, végül
számként ellenőrizzük (5 megfelel a "5", "5s" és "5 s" formátumú értékeknek).
Alapértékek
A kihagyott paraméterek a modell alapértékét használják, amely a modell paramétertáblázatában szerepel. Az árat is
ugyanezekkel az alapértékekkel számítjuk ki (például egy olyan videómodell esetén, amelynél a generate_audio
alapértéke true, a díjszámítás hanggal történik, kivéve, ha a következőt küldöd: "generate_audio": false).
Fájlparaméterek
A kép-, videó- és hangparaméterek nyilvános URL-t, legfeljebb 10 MB méretű data: URI-t vagy egy feltöltés
file_url értékét fogadják el. Lásd: Fájlok.