Parametre
Alle modeller beholder deres oprindelige parameternavne, og hver models side viser dem. Derudover accepterer API'et kanoniske navne for de parametre, der betyder det samme på alle modeller, så kode skrevet til én model fungerer med den næste med færre ændringer.
Kanoniske navne
| Kanonisk navn | Betydning | Typiske oprindelige navne |
|---|---|---|
image |
Inputbilledet eller billedet af første frame | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Billedet af sidste frame | end_image_url, last_frame_url, tail_image_url |
images |
En liste over referencebilleder | image_urls, reference_image_urls |
video |
Inputvideoen | video_url |
videos |
En liste over referencevideoer | video_urls |
audio |
Inputlyden | audio_url |
audios |
En liste over referenceklip med lyd | audio_urls |
mask |
Et maskebillede | mask_url |
num_outputs |
Hvor mange resultater der skal genereres | num_images |
generate_audio |
Generer lyd sammen med videoen | generate_audio_switch, enable_audio |
Hvilket oprindeligt felt et kanonisk navn knytter sig til på hver aktuelle model:
| Kanonisk navn | Indbygget felt (modeller, der bruger 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 navn eller det oprindelige navn. Hvis du sender begge med forskellige værdier, mislykkes kaldet med
422 invalid_inputpå det kanoniske navn. - En parameter, der hverken er et oprindeligt eller kanonisk navn for modellen, afvises med
422 invalid_input("Unknown parameter") sammen med det nærmeste gyldige navn som forslag. Slåfejl går aldrig ubemærket igennem. - Hver models side viser begge navne side om side.
Typekonvertering
Værdier konverteres til den type, modellen forventer, så alt dette fungerer:
| Du sender | Modellen forventer | Bliver til |
|---|---|---|
5, "5", "5s" |
duration som en streng, f.eks. "5" |
"5" |
"8" |
et heltal | 8 |
"1080P", "4K" |
resolution såsom "1080p", "4k" |
den nøjagtige tilladte stavemåde |
"true", "false", 1, 0 |
en boolsk værdi | true, false |
"https://…/a.jpg" |
en liste over URL'er | ["https://…/a.jpg"] |
42 |
en streng | "42" |
Tilladte værdier sammenlignes først nøjagtigt, derefter uden hensyn til store og små bogstaver og til sidst som tal (5 matcher "5", "5s" og
værdier i stil med "5 s").
Standardværdier
Parametre, du udelader, bruger modellens standardværdi, som er angivet i modellens parametertabel. Prisen
beregnes med de samme standardværdier (en videomodel, hvis generate_audio som standard er true, prissættes f.eks. med
lyd, medmindre du sender "generate_audio": false).
Filparametre
Billed-, video- og lydparametre accepterer en offentlig URL, en data:-URI på op til 10 MB eller file_url fra en upload.
Se Filer.