Parametere
Alle modeller beholder sine opprinnelige parameternavn, og hver modells side viser dem. I tillegg godtar API-et kanoniske navn for parametere som betyr det samme i alle modeller, slik at kode som er skrevet for én modell, fungerer for den neste med færre endringer.
Kanoniske navn
| Kanonisk navn | Betydning | Vanlige opprinnelige navn |
|---|---|---|
image |
Inndatabildet eller bildet i første bilde | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Bildet i siste bilde | end_image_url, last_frame_url, tail_image_url |
images |
En liste med referansebilder | image_urls, reference_image_urls |
video |
Inndatavideoen | video_url |
videos |
En liste med referansevideoer | video_urls |
audio |
Inndataudioen | audio_url |
audios |
En liste med referanselydopptak | audio_urls |
mask |
Et maskebilde | mask_url |
num_outputs |
Hvor mange resultater som skal genereres | num_images |
generate_audio |
Generer lyd sammen med videoen | generate_audio_switch, enable_audio |
Hvilket opprinnelig felt et kanonisk navn tilordnes i hver gjeldende modell:
| Kanonisk navn | Opprinnelig felt (modeller som bruker det) |
|---|---|
audio |
audio_url (modeller: 126) |
audios |
audio_urls (modeller: 7), reference_audio_urls (modeller: 1) |
end_image |
end_image_url (modeller: 76), last_frame_url (modeller: 12), tail_image_url (modeller: 1) |
generate_audio |
generate_audio_switch (modeller: 16), audio (modeller: 3) |
image |
image_url (modeller: 529), start_image_url (modeller: 20), first_frame_url (modeller: 12), first_image_url (modeller: 7), source_image_url (modeller: 2) |
images |
image_urls (modeller: 148), reference_image_urls (modeller: 31) |
mask |
mask_url (modeller: 46) |
num_outputs |
num_images (modeller: 337) |
video |
video_url (modeller: 197) |
videos |
video_urls (modeller: 13), reference_video_urls (modeller: 1) |
Regler:
- Send enten det kanoniske navnet eller det opprinnelige navnet. Hvis du sender begge med forskjellige verdier, mislykkes kallet med
422 invalid_inputpå det kanoniske navnet. - En parameter som verken er et opprinnelig eller et kanonisk navn for modellen, avvises med
422 invalid_input("Ukjent parameter"), sammen med det nærmeste gyldige navnet som forslag. Skrivefeil slipper aldri gjennom ubemerket. - Hver modells side viser begge navnene side om side.
Typekonvertering
Verdier konverteres til typen modellen forventer, så alt dette fungerer:
| Du sender | Modellen forventer | Blir til |
|---|---|---|
5, "5", "5s" |
duration som en streng, for eksempel "5" |
"5" |
"8" |
et heltall | 8 |
"1080P", "4K" |
resolution, for eksempel "1080p", "4k" |
den nøyaktige tillatte skrivemåten |
"true", "false", 1, 0 |
en boolsk verdi | true, false |
"https://…/a.jpg" |
en liste med URL-er | ["https://…/a.jpg"] |
42 |
en streng | "42" |
Tillatte verdier samsvares først nøyaktig, deretter uten hensyn til store og små bokstaver, og til slutt som tall (5 samsvarer med "5", "5s" og
verdier av typen "5 s").
Standardverdier
Parametere du utelater, bruker modellens standardverdi, som er oppført i modellens parametertabell. Prisen
beregnes med de samme standardverdiene (for eksempel prises en videomodell der generate_audio har standardverdien true, med
lyd med mindre du sender "generate_audio": false).
Filparametere
Bilde-, video- og lydparametere tar en offentlig URL, en data:-URI på opptil 10 MB eller file_url for en opplasting.
Se Filer.