# Parameteren

All Modell behält seng natierlech Parameternimm, an all Modell-Säit list dës op. Zousätzlech akzeptéiert d'API
**kanonësch Nimm** fir d'Parameteren, déi op all Modell datselwecht bedeiten, sou datt Code, dee fir ee Modell geschriwwe gouf, mat manner Ännerunge fir den nächste funktionéiert.

## Kanonësch Nimm

| Kanonëschen Numm | Bedeitung | Typesch natierlech Nimm |
|---|---|---|
| `image` | D'Input- oder éischt-Frame-Bild | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Dat lescht-Frame-Bild | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Eng Lëscht vu Referenzbiller | `image_urls`, `reference_image_urls` |
| `video` | Den Input-Video | `video_url` |
| `videos` | Eng Lëscht vu Referenzvideoen | `video_urls` |
| `audio` | Den Input-Audio | `audio_url` |
| `audios` | Eng Lëscht vu Referenz-Audioclips | `audio_urls` |
| `mask` | E Maskebild | `mask_url` |
| `num_outputs` | Wéi vill Resultater generéiert solle ginn | `num_images` |
| `generate_audio` | Toun mam Video generéieren | `generate_audio_switch`, `enable_audio` |

Op wéi en natierlecht Feld e kanonëschen Numm bei all aktuelle Modell zougewise gëtt:

| Kanoneschen Numm | Originalfeld (Modeller, déi et benotzen) |
|---|---|
| `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) |

Reegelen:

- Schéckt entweder de kanonëschen Numm oder den natierlechen Numm. Wann Dir béid mat verschiddene Wäerter schéckt, feelt den Opruff mat
  `422 invalid_input` beim kanonëschen Numm.
- E Parameter, deen weder en natierlechen nach e kanonëschen Numm vum Modell ass, gëtt mat `422 invalid_input`
  ("Unknown parameter") zeréckgewisen, zesumme mam noosten gültegen Numm als Virschlag. Tippfeeler ginn ni stillschweigend akzeptéiert.
- All Modell-Säit weist béid Nimm niefteneen.

## Typkonversioun

Wäerter ginn an den Typ ëmgewandelt, deen de Modell erwaart, sou datt all dës Beispiller funktionéieren:

| Dir schéckt | De Modell erwaart | Gëtt zu |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` als String wéi `"5"` | `"5"` |
| `"8"` | eng ganz Zuel | `8` |
| `"1080P"`, `"4K"` | `resolution` wéi `"1080p"`, `"4k"` | déi genee erlaabte Schreifweis |
| `"true"`, `"false"`, `1`, `0` | e boolesche Wäert | `true`, `false` |
| `"https://…/a.jpg"` | eng Lëscht vun URLen | `["https://…/a.jpg"]` |
| `42` | e String | `"42"` |

Erlaabte Wäerter ginn als éischt genee ofgeglach, duerno ouni Berécksiichtegung vu Grouss- a Klengschreiwung, an duerno als Zuelen (`5` entsprécht Wäerter wéi `"5"`, `"5s"` an
`"5 s"`).

## Standardwäerter

Parameteren, déi Dir fortloosst, benotzen de Standardwäert vum Modell, deen an der Parametertabell vum Modell opgelëscht ass. De Präis gëtt mat deene selwechte Standardwäerter berechent (zum Beispill gëtt e Videomodell, bei deem `generate_audio` standardméisseg op `true` steet, mat Toun berechent, ausser Dir schéckt `"generate_audio": false`).

## Datei-Parameteren

Bild-, Video- an Audio-Parameteren akzeptéieren eng ëffentlech URL, e `data:`-URI bis zu 10 MB oder den `file_url` vun engem Upload.
Kuckt [Dateien](https://doitong.com/developers/docs/files).