# Parametre

Alle modeller beholder deres oprindelige parameternavne, og hver models side viser dem. Derudover accepterer API'et
**kanoniske navne** for de parametre, der betyder det samme på alle modeller, så kode skrevet til én model fungerer
med den næste med færre ændringer.

## Kanoniske navne

| Kanonisk navn | Betydning | Typiske oprindelige navne |
|---|---|---|
| `image` | Inputbilledet eller billedet af første frame | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Billedet af sidste frame | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | En liste over referencebilleder | `image_urls`, `reference_image_urls` |
| `video` | Inputvideoen | `video_url` |
| `videos` | En liste over referencevideoer | `video_urls` |
| `audio` | Inputlyden | `audio_url` |
| `audios` | En liste over referenceklip med lyd | `audio_urls` |
| `mask` | Et maskebillede | `mask_url` |
| `num_outputs` | Hvor mange resultater der skal genereres | `num_images` |
| `generate_audio` | Generer lyd sammen med videoen | `generate_audio_switch`, `enable_audio` |

Hvilket oprindeligt felt et kanonisk navn knytter sig til på hver aktuelle model:

| Kanonisk navn | Indbygget felt (modeller, der bruger 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 navn eller det oprindelige navn. Hvis du sender begge med forskellige værdier, mislykkes kaldet med
  `422 invalid_input` på det kanoniske navn.
- En parameter, der hverken er et oprindeligt eller kanonisk navn for modellen, afvises med `422 invalid_input`
  ("Unknown parameter") sammen med det nærmeste gyldige navn som forslag. Slåfejl går aldrig ubemærket igennem.
- Hver models side viser begge navne side om side.

## Typekonvertering

Værdier konverteres til den type, modellen forventer, så alt dette fungerer:

| Du sender | Modellen forventer | Bliver til |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` som en streng, f.eks. `"5"` | `"5"` |
| `"8"` | et heltal | `8` |
| `"1080P"`, `"4K"` | `resolution` såsom `"1080p"`, `"4k"` | den nøjagtige tilladte stavemåde |
| `"true"`, `"false"`, `1`, `0` | en boolsk værdi | `true`, `false` |
| `"https://…/a.jpg"` | en liste over URL'er | `["https://…/a.jpg"]` |
| `42` | en streng | `"42"` |

Tilladte værdier sammenlignes først nøjagtigt, derefter uden hensyn til store og små bogstaver og til sidst som tal (`5` matcher `"5"`, `"5s"` og
værdier i stil med `"5 s"`).

## Standardværdier

Parametre, du udelader, bruger modellens standardværdi, som er angivet i modellens parametertabel. Prisen
beregnes med de samme standardværdier (en videomodel, hvis `generate_audio` som standard er `true`, prissættes f.eks. med
lyd, medmindre du sender `"generate_audio": false`).

## Filparametre

Billed-, video- og lydparametre accepterer en offentlig URL, en `data:`-URI på op til 10 MB eller `file_url` fra en upload.
Se [Filer](https://doitong.com/developers/docs/files).