# Paraméterek

Minden modell megtartja a natív paraméterneveit, és minden modelloldal felsorolja ezeket. Emellett az API elfogad
**kanonikus neveket** azokhoz a paraméterekhez, amelyek minden modellen ugyanazt jelentik, így az egyik modellhez írt kód
kevesebb módosítással használható a következő modellen is.

## Kanonikus nevek

| Kanonikus név | Jelentés | Tipikus natív nevek |
|---|---|---|
| `image` | A bemeneti vagy első képkocka képe | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Az utolsó képkocka képe | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Referenciaképek listája | `image_urls`, `reference_image_urls` |
| `video` | A bemeneti videó | `video_url` |
| `videos` | Referenciavideók listája | `video_urls` |
| `audio` | A bemeneti hang | `audio_url` |
| `audios` | Referencia-hangklippek listája | `audio_urls` |
| `mask` | Maszkkép | `mask_url` |
| `num_outputs` | A generálandó eredmények száma | `num_images` |
| `generate_audio` | Hang generálása a videóval együtt | `generate_audio_switch`, `enable_audio` |

Az egyes aktuális modelleken a kanonikus név által leképezett natív mező:

| Kanonikus név | Natív mező (az ezt használó modellek) |
|---|---|
| `audio` | `audio_url` (modellek: 126) |
| `audios` | `audio_urls` (modellek: 7), `reference_audio_urls` (modellek: 1) |
| `end_image` | `end_image_url` (modellek: 76), `last_frame_url` (modellek: 12), `tail_image_url` (modellek: 1) |
| `generate_audio` | `generate_audio_switch` (modellek: 16), `audio` (modellek: 3) |
| `image` | `image_url` (modellek: 529), `start_image_url` (modellek: 20), `first_frame_url` (modellek: 12), `first_image_url` (modellek: 7), `source_image_url` (modellek: 2) |
| `images` | `image_urls` (modellek: 148), `reference_image_urls` (modellek: 31) |
| `mask` | `mask_url` (modellek: 46) |
| `num_outputs` | `num_images` (modellek: 337) |
| `video` | `video_url` (modellek: 197) |
| `videos` | `video_urls` (modellek: 13), `reference_video_urls` (modellek: 1) |

Szabályok:

- Küldd el vagy a kanonikus nevet, vagy a natív nevet. Ha mindkettőt elküldöd eltérő értékekkel, a hívás meghiúsul a
  kanonikus névhez tartozó `422 invalid_input` hibával.
- A modell sem natív, sem kanonikus nevének nem megfelelő paraméter elutasításra kerül `422 invalid_input` hibával
  ("Ismeretlen paraméter"), és a rendszer javaslatként megadja a legközelebbi érvényes nevet. Az elgépelések soha nem
  mennek át csendben.
- Minden modelloldal egymás mellett jeleníti meg mindkét nevet.

## Típuskonverzió

Az értékek a modell által elvárt típusra konvertálódnak, ezért az alábbiak mind működnek:

| Ezt küldöd | Ezt várja a modell | Ebből lesz |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` stringként, például `"5"` | `"5"` |
| `"8"` | egész szám | `8` |
| `"1080P"`, `"4K"` | `resolution`, például `"1080p"`, `"4k"` | a pontosan engedélyezett írásmód |
| `"true"`, `"false"`, `1`, `0` | logikai érték | `true`, `false` |
| `"https://…/a.jpg"` | URL-ek listája | `["https://…/a.jpg"]` |
| `42` | string | `"42"` |

Az engedélyezett értékeket először pontos egyezéssel, majd a kis- és nagybetűk figyelmen kívül hagyásával, végül
számként ellenőrizzük (`5` megfelel a `"5"`, `"5s"` és `"5 s"` formátumú értékeknek).

## Alapértékek

A kihagyott paraméterek a modell alapértékét használják, amely a modell paramétertáblázatában szerepel. Az árat is
ugyanezekkel az alapértékekkel számítjuk ki (például egy olyan videómodell esetén, amelynél a `generate_audio`
alapértéke `true`, a díjszámítás hanggal történik, kivéve, ha a következőt küldöd: `"generate_audio": false`).

## Fájlparaméterek

A kép-, videó- és hangparaméterek nyilvános URL-t, legfeljebb 10 MB méretű `data:` URI-t vagy egy feltöltés
`file_url` értékét fogadják el. Lásd: [Fájlok](https://doitong.com/developers/docs/files).