# Parameter

Setiap model mempertahankan nama parameter bawaannya, dan setiap halaman model mencantumkannya. Selain itu, API menerima
**nama kanonis** untuk parameter yang memiliki arti sama pada setiap model, sehingga kode yang ditulis untuk satu model dapat digunakan
pada model berikutnya dengan lebih sedikit perubahan.

## Nama kanonis

| Nama kanonis | Arti | Nama bawaan yang umum |
|---|---|---|
| `image` | Gambar input atau bingkai pertama | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Gambar bingkai terakhir | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Daftar gambar referensi | `image_urls`, `reference_image_urls` |
| `video` | Video input | `video_url` |
| `videos` | Daftar video referensi | `video_urls` |
| `audio` | Audio input | `audio_url` |
| `audios` | Daftar klip audio referensi | `audio_urls` |
| `mask` | Gambar mask | `mask_url` |
| `num_outputs` | Jumlah hasil yang akan dibuat | `num_images` |
| `generate_audio` | Membuat suara bersama video | `generate_audio_switch`, `enable_audio` |

Field bawaan yang dipetakan oleh setiap nama kanonis pada setiap model saat ini:

| Nama kanonis | Field native (model yang menggunakannya) |
|---|---|
| `audio` | `audio_url` (model: 126) |
| `audios` | `audio_urls` (model: 7), `reference_audio_urls` (model: 1) |
| `end_image` | `end_image_url` (model: 76), `last_frame_url` (model: 12), `tail_image_url` (model: 1) |
| `generate_audio` | `generate_audio_switch` (model: 16), `audio` (model: 3) |
| `image` | `image_url` (model: 529), `start_image_url` (model: 20), `first_frame_url` (model: 12), `first_image_url` (model: 7), `source_image_url` (model: 2) |
| `images` | `image_urls` (model: 148), `reference_image_urls` (model: 31) |
| `mask` | `mask_url` (model: 46) |
| `num_outputs` | `num_images` (model: 337) |
| `video` | `video_url` (model: 197) |
| `videos` | `video_urls` (model: 13), `reference_video_urls` (model: 1) |

Aturan:

- Kirim nama kanonis atau nama bawaannya. Jika Anda mengirim keduanya dengan nilai berbeda, panggilan gagal dengan
  `422 invalid_input` pada nama kanonis.
- Parameter yang bukan nama bawaan maupun nama kanonis model akan ditolak dengan `422 invalid_input`
  ("Parameter tidak dikenal"), beserta nama valid terdekat sebagai saran. Kesalahan ketik tidak pernah lolos tanpa pemberitahuan.
- Setiap halaman model menampilkan kedua nama tersebut berdampingan.

## Koersi tipe

Nilai dikonversi ke tipe yang diharapkan model, sehingga semua contoh berikut berfungsi:

| Yang Anda kirim | Yang diharapkan model | Menjadi |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` sebagai string seperti `"5"` | `"5"` |
| `"8"` | bilangan bulat | `8` |
| `"1080P"`, `"4K"` | `resolution` seperti `"1080p"`, `"4k"` | ejaan yang diizinkan secara tepat |
| `"true"`, `"false"`, `1`, `0` | boolean | `true`, `false` |
| `"https://…/a.jpg"` | daftar URL | `["https://…/a.jpg"]` |
| `42` | string | `"42"` |

Nilai yang diizinkan dicocokkan secara tepat terlebih dahulu, lalu tanpa membedakan huruf besar-kecil, kemudian sebagai angka (`5` cocok dengan nilai bergaya `"5"`, `"5s"`, dan
`"5 s"`).

## Bawaan

Parameter yang tidak Anda sertakan akan menggunakan nilai bawaan model, yang tercantum dalam tabel parameter model. Harga
dihitung menggunakan nilai bawaan yang sama (misalnya, model video yang `generate_audio`-nya secara bawaan adalah `true` akan dihargai dengan
suara kecuali Anda mengirim `"generate_audio": false`).

## Parameter file

Parameter gambar, video, dan audio menerima URL publik, URI `data:` hingga 10 MB, atau `file_url` dari file yang diunggah.
Lihat [File](https://doitong.com/developers/docs/files).