Parametri
Katrs modelis saglabā savus vietējos parametru nosaukumus, un katra modeļa lapā tie ir norādīti. Turklāt API pieņem kanoniskos nosaukumus parametriem, kas visos modeļos nozīmē vienu un to pašu, tāpēc vienam modelim rakstīts kods darbojas arī nākamajam modelim, veicot mazāk izmaiņu.
Kanoniskie nosaukumi
| Kanoniskais nosaukums | Nozīme | Tipiskie vietējie nosaukumi |
|---|---|---|
image |
Ievades vai pirmā kadra attēls | image_url, start_image_url, first_frame_url, first_image_url, source_image_url |
end_image |
Pēdējā kadra attēls | end_image_url, last_frame_url, tail_image_url |
images |
Atsauces attēlu saraksts | image_urls, reference_image_urls |
video |
Ievades video | video_url |
videos |
Atsauces videoklipu saraksts | video_urls |
audio |
Ievades audio | audio_url |
audios |
Atsauces audio klipu saraksts | audio_urls |
mask |
Maskas attēls | mask_url |
num_outputs |
Ģenerējamo rezultātu skaits | num_images |
generate_audio |
Ģenerēt skaņu kopā ar video | generate_audio_switch, enable_audio |
Kuram vietējam laukam katrā pašreizējā modelī atbilst kanoniskais nosaukums:
| Kanoniskais nosaukums | Vietējais lauks (modeļi, kas to izmanto) |
|---|---|
audio |
audio_url (modeļi: 126) |
audios |
audio_urls (modeļi: 7), reference_audio_urls (modeļi: 1) |
end_image |
end_image_url (modeļi: 76), last_frame_url (modeļi: 12), tail_image_url (modeļi: 1) |
generate_audio |
generate_audio_switch (modeļi: 16), audio (modeļi: 3) |
image |
image_url (modeļi: 529), start_image_url (modeļi: 20), first_frame_url (modeļi: 12), first_image_url (modeļi: 7), source_image_url (modeļi: 2) |
images |
image_urls (modeļi: 148), reference_image_urls (modeļi: 31) |
mask |
mask_url (modeļi: 46) |
num_outputs |
num_images (modeļi: 337) |
video |
video_url (modeļi: 197) |
videos |
video_urls (modeļi: 13), reference_video_urls (modeļi: 1) |
Noteikumi:
- Nosūtiet vai nu kanonisko nosaukumu, vai vietējo nosaukumu. Ja nosūtāt abus ar atšķirīgām vērtībām, izsaukums neizdodas ar
422 invalid_inputkanoniskajam nosaukumam. - Parametrs, kas nav ne modeļa vietējais, ne kanoniskais nosaukums, tiek noraidīts ar
422 invalid_input("Unknown parameter"), norādot tuvāko derīgo nosaukumu. Drukas kļūdas nekad netiek nepamanītas. - Katras modeļa lapā abi nosaukumi ir parādīti blakus.
Tipu konvertēšana
Vērtības tiek pārveidotas par tipu, ko sagaida modelis, tāpēc visi šie varianti darbojas:
| Jūs nosūtāt | Modelis sagaida | Kļūst par |
|---|---|---|
5, "5", "5s" |
duration kā virkni, piemēram, "5" |
"5" |
"8" |
veselu skaitli | 8 |
"1080P", "4K" |
resolution, piemēram, "1080p", "4k" |
precīzi atļautais rakstības variants |
"true", "false", 1, 0 |
Būla vērtību | true, false |
"https://…/a.jpg" |
URL sarakstu | ["https://…/a.jpg"] |
42 |
virkni | "42" |
Vispirms atļautās vērtības tiek salīdzinātas precīzi, pēc tam, neņemot vērā reģistru, un visbeidzot kā skaitļi (5 atbilst "5", "5s" un
"5 s" tipa vērtībām).
Noklusējuma vērtības
Izlaistajiem parametriem tiek izmantota modeļa noklusējuma vērtība, kas norādīta modeļa parametru tabulā. Cena tiek
aprēķināta, izmantojot tās pašas noklusējuma vērtības (piemēram, video modelim, kura generate_audio noklusējuma vērtība ir true, cena tiek aprēķināta ar
skaņu, ja vien nenosūtāt "generate_audio": false).
Failu parametri
Attēlu, video un audio parametriem var izmantot publisku URL, data: URI līdz 10 MB vai augšupielādes file_url.
Skatiet Files.