Parameteren
All Modell behält seng natierlech Parameternimm, an all Modell-Säit list dës op. Zousätzlech akzeptéiert d'API kanonësch Nimm fir d'Parameteren, déi op all Modell datselwecht bedeiten, sou datt Code, dee fir ee Modell geschriwwe gouf, mat manner Ännerunge fir den nächste funktionéiert.
Kanonësch Nimm
| Kanonëschen Numm | Bedeitung | Typesch natierlech Nimm |
|---|---|---|
image |
D'Input- oder éischt-Frame-Bild | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Dat lescht-Frame-Bild | end_image_url, last_frame_url, tail_image_url |
images |
Eng Lëscht vu Referenzbiller | image_urls, reference_image_urls |
video |
Den Input-Video | video_url |
videos |
Eng Lëscht vu Referenzvideoen | video_urls |
audio |
Den Input-Audio | audio_url |
audios |
Eng Lëscht vu Referenz-Audioclips | audio_urls |
mask |
E Maskebild | mask_url |
num_outputs |
Wéi vill Resultater generéiert solle ginn | num_images |
generate_audio |
Toun mam Video generéieren | generate_audio_switch, enable_audio |
Op wéi en natierlecht Feld e kanonëschen Numm bei all aktuelle Modell zougewise gëtt:
| Kanoneschen Numm | Originalfeld (Modeller, déi et benotzen) |
|---|---|
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) |
Reegelen:
- Schéckt entweder de kanonëschen Numm oder den natierlechen Numm. Wann Dir béid mat verschiddene Wäerter schéckt, feelt den Opruff mat
422 invalid_inputbeim kanonëschen Numm. - E Parameter, deen weder en natierlechen nach e kanonëschen Numm vum Modell ass, gëtt mat
422 invalid_input("Unknown parameter") zeréckgewisen, zesumme mam noosten gültegen Numm als Virschlag. Tippfeeler ginn ni stillschweigend akzeptéiert. - All Modell-Säit weist béid Nimm niefteneen.
Typkonversioun
Wäerter ginn an den Typ ëmgewandelt, deen de Modell erwaart, sou datt all dës Beispiller funktionéieren:
| Dir schéckt | De Modell erwaart | Gëtt zu |
|---|---|---|
5, "5", "5s" |
duration als String wéi "5" |
"5" |
"8" |
eng ganz Zuel | 8 |
"1080P", "4K" |
resolution wéi "1080p", "4k" |
déi genee erlaabte Schreifweis |
"true", "false", 1, 0 |
e boolesche Wäert | true, false |
"https://…/a.jpg" |
eng Lëscht vun URLen | ["https://…/a.jpg"] |
42 |
e String | "42" |
Erlaabte Wäerter ginn als éischt genee ofgeglach, duerno ouni Berécksiichtegung vu Grouss- a Klengschreiwung, an duerno als Zuelen (5 entsprécht Wäerter wéi "5", "5s" an
"5 s").
Standardwäerter
Parameteren, déi Dir fortloosst, benotzen de Standardwäert vum Modell, deen an der Parametertabell vum Modell opgelëscht ass. De Präis gëtt mat deene selwechte Standardwäerter berechent (zum Beispill gëtt e Videomodell, bei deem generate_audio standardméisseg op true steet, mat Toun berechent, ausser Dir schéckt "generate_audio": false).
Datei-Parameteren
Bild-, Video- an Audio-Parameteren akzeptéieren eng ëffentlech URL, e data:-URI bis zu 10 MB oder den file_url vun engem Upload.
Kuckt Dateien.