# Parametarat

Juohke modell doallá iežas natiivalaš parametrade namaid, ja juohke modellsiidu čájeha daid. Dasa lassin API dohkkeha
**kanonalaš namaid** parametrat main lea seamma mearkkašupmi buot modellain, nu ahte koda mii lea čállojuvvon ovtta
modella várás doaibmá boahtte modellas unnit rievdadusaiguin.

## Kanonalaš namat

| Kanonalaš namma | Mearkkašupmi | Dábálaš natiivalaš namat |
|---|---|---|
| `image` | Sisadoallu dahje vuosttaš ráma govva | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Maŋimuš ráma govva | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Referánsa-govaid listu | `image_urls`, `reference_image_urls` |
| `video` | Sisadoallu video | `video_url` |
| `videos` | Referánsa-videoid listu | `video_urls` |
| `audio` | Sisadoallu audio | `audio_url` |
| `audios` | Referánsa-audio-klippaid listu | `audio_urls` |
| `mask` | Maskagovva | `mask_url` |
| `num_outputs` | Galle bohtosa genereret | `num_images` |
| `generate_audio` | Generere jiena ovttas videoin | `generate_audio_switch`, `enable_audio` |

Guhte natiivalaš fielda kanonalaš namma čuovvu juohke dálá modellas:

| Kanonalaš namma | Natiiva gieda (modeallat geavahit dan) |
|---|---|
| `audio` | `audio_url` (modeallat: 126) |
| `audios` | `audio_urls` (modeallat: 7), `reference_audio_urls` (modeallat: 1) |
| `end_image` | `end_image_url` (modeallat: 76), `last_frame_url` (modeallat: 12), `tail_image_url` (modeallat: 1) |
| `generate_audio` | `generate_audio_switch` (modeallat: 16), `audio` (modeallat: 3) |
| `image` | `image_url` (modeallat: 529), `start_image_url` (modeallat: 20), `first_frame_url` (modeallat: 12), `first_image_url` (modeallat: 7), `source_image_url` (modeallat: 2) |
| `images` | `image_urls` (modeallat: 148), `reference_image_urls` (modeallat: 31) |
| `mask` | `mask_url` (modeallat: 46) |
| `num_outputs` | `num_images` (modeallat: 337) |
| `video` | `video_url` (modeallat: 197) |
| `videos` | `video_urls` (modeallat: 13), `reference_video_urls` (modeallat: 1) |

Njuolggadusat:

- Sádde cealkka kanonalaš nama dahje natiivalaš nama. Jus sáddegoappašiid iešguđetlágan árvvuiguin, de gohččuma
  ii dohkkehuvvo `422 invalid_input` kanonalaš nama bokte.
- Parameter mii ii leat modella natiivalaš dahje kanonalaš namma hilgojuvvo `422 invalid_input`
  ("Unknown parameter"), ja sugererejuvvo lagamus gustojeaddji namma. Čáhppesčállinbohtut eai goassege man
  čihkosis čađa.
- Juohke modellsiidu čájeha goappašiid namaid bálddalagaid.

## Type-konverteren

Árvvut konverterejit dan type-i, maid modell vuordá, nu ahte dát buot doaibmet:

| Don sáddet | Modell vuordá | Šaddá |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` stringan dego `"5"` | `"5"` |
| `"8"` | integer | `8` |
| `"1080P"`, `"4K"` | `resolution` dego `"1080p"`, `"4k"` | dárbbašlaš beallječállin |
| `"true"`, `"false"`, `1`, `0` | boolean | `true`, `false` |
| `"https://…/a.jpg"` | URL:aid listu | `["https://…/a.jpg"]` |
| `42` | string | `"42"` |

Dohkkehuvvon árvvut geahččojit vuosttáš dárkilit, de goikkanassii cealkagiskon, ja lohkui (`5` heive `"5"`, `"5s"` ja
`"5 s"`-stílla árvvuide).

## Oŋgonárvut

Parametarat maid don guođát eret geavahit modella oŋgonárvvu, mii lea čájehuvvon modella parameteratabeallas. Haddu
rehkenejuvvo seamma oŋgonárvvuiguin (ovdamearkka dihte video-modell, mas `generate_audio` oŋgonárvu lea `true`, haddá
jiena mielde, juos don it sáđe `"generate_audio": false`).

## Fiila-parametarat

Govva-, video- ja audio-parametarat váldet almmolaš URL:a, `data:` URI:a gitta 10 MB rádjái, dahje uploada
`file_url`-a. Geahča [Files](https://doitong.com/developers/docs/files).