# Parametere

Alle modeller beholder sine opprinnelige parameternavn, og hver modells side viser dem. I tillegg godtar API-et
**kanoniske navn** for parametere som betyr det samme i alle modeller, slik at kode som er skrevet for én modell, fungerer
for den neste med færre endringer.

## Kanoniske navn

| Kanonisk navn | Betydning | Vanlige opprinnelige navn |
|---|---|---|
| `image` | Inndatabildet eller bildet i første bilde | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Bildet i siste bilde | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | En liste med referansebilder | `image_urls`, `reference_image_urls` |
| `video` | Inndatavideoen | `video_url` |
| `videos` | En liste med referansevideoer | `video_urls` |
| `audio` | Inndataudioen | `audio_url` |
| `audios` | En liste med referanselydopptak | `audio_urls` |
| `mask` | Et maskebilde | `mask_url` |
| `num_outputs` | Hvor mange resultater som skal genereres | `num_images` |
| `generate_audio` | Generer lyd sammen med videoen | `generate_audio_switch`, `enable_audio` |

Hvilket opprinnelig felt et kanonisk navn tilordnes i hver gjeldende modell:

| Kanonisk navn | Opprinnelig felt (modeller som bruker 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 navnet eller det opprinnelige navnet. Hvis du sender begge med forskjellige verdier, mislykkes kallet med
  `422 invalid_input` på det kanoniske navnet.
- En parameter som verken er et opprinnelig eller et kanonisk navn for modellen, avvises med `422 invalid_input`
  ("Ukjent parameter"), sammen med det nærmeste gyldige navnet som forslag. Skrivefeil slipper aldri gjennom ubemerket.
- Hver modells side viser begge navnene side om side.

## Typekonvertering

Verdier konverteres til typen modellen forventer, så alt dette fungerer:

| Du sender | Modellen forventer | Blir til |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` som en streng, for eksempel `"5"` | `"5"` |
| `"8"` | et heltall | `8` |
| `"1080P"`, `"4K"` | `resolution`, for eksempel `"1080p"`, `"4k"` | den nøyaktige tillatte skrivemåten |
| `"true"`, `"false"`, `1`, `0` | en boolsk verdi | `true`, `false` |
| `"https://…/a.jpg"` | en liste med URL-er | `["https://…/a.jpg"]` |
| `42` | en streng | `"42"` |

Tillatte verdier samsvares først nøyaktig, deretter uten hensyn til store og små bokstaver, og til slutt som tall (`5` samsvarer med `"5"`, `"5s"` og
verdier av typen `"5 s"`).

## Standardverdier

Parametere du utelater, bruker modellens standardverdi, som er oppført i modellens parametertabell. Prisen
beregnes med de samme standardverdiene (for eksempel prises en videomodell der `generate_audio` har standardverdien `true`, med
lyd med mindre du sender `"generate_audio": false`).

## Filparametere

Bilde-, video- og lydparametere tar en offentlig URL, en `data:`-URI på opptil 10 MB eller `file_url` for en opplasting.
Se [Filer](https://doitong.com/developers/docs/files).