# 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_input` kanoniskajam 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](https://doitong.com/developers/docs/files).