# Parametreler

Her model kendi yerel parametre adlarını kullanır ve her model sayfasında bunlar listelenir. Bunun yanı sıra API,
her modelde aynı anlama gelen parametreler için **standart adları** kabul eder; böylece bir model için yazılan kod,
bir sonraki model için daha az değişiklikle çalışır.

## Standart adlar

| Standart ad | Anlamı | Tipik yerel adlar |
|---|---|---|
| `image` | Girdi veya ilk kare görüntüsü | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Son kare görüntüsü | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Referans görüntülerinin listesi | `image_urls`, `reference_image_urls` |
| `video` | Girdi videosu | `video_url` |
| `videos` | Referans videolarının listesi | `video_urls` |
| `audio` | Girdi sesi | `audio_url` |
| `audios` | Referans ses kliplerinin listesi | `audio_urls` |
| `mask` | Maske görüntüsü | `mask_url` |
| `num_outputs` | Oluşturulacak sonuç sayısı | `num_images` |
| `generate_audio` | Videoyla birlikte ses oluştur | `generate_audio_switch`, `enable_audio` |

Her güncel modelde bir standart adın hangi yerel alana eşlendiği:

| Kanonik ad | Yerel alan (kullanan modeller) |
|---|---|
| `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) |

Kurallar:

- Standart adı veya yerel adı gönderin. Farklı değerlerle ikisini birden gönderirseniz çağrı, standart ad için
  `422 invalid_input` hatasıyla başarısız olur.
- Modelin yerel veya standart adı olmayan bir parametre `422 invalid_input` ("Unknown parameter") ile reddedilir
  ve en yakın geçerli ad öneri olarak sunulur. Yazım hataları hiçbir zaman sessizce kabul edilmez.
- Her model sayfası her iki adı yan yana gösterir.

## Tür dönüşümü

Değerler, modelin beklediği türe dönüştürülür; bu nedenle aşağıdakilerin tümü çalışır:

| Gönderdiğiniz | Modelin beklediği | Dönüşür |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration`, `"5"` gibi bir dize | `"5"` |
| `"8"` | bir tam sayı | `8` |
| `"1080P"`, `"4K"` | `"1080p"`, `"4k"` gibi bir `resolution` | izin verilen tam yazım |
| `"true"`, `"false"`, `1`, `0` | bir boolean | `true`, `false` |
| `"https://…/a.jpg"` | URL listesi | `["https://…/a.jpg"]` |
| `42` | bir dize | `"42"` |

İzin verilen değerler önce tam olarak, ardından büyük/küçük harf göz ardı edilerek, sonra da sayı olarak eşleştirilir
(`5`, `"5"`, `"5s"` ve `"5 s"` biçimindeki değerlerle eşleşir).

## Varsayılanlar

Belirtmediğiniz parametreler, modelin parametre tablosunda listelenen varsayılan değeri kullanır. Fiyat aynı
varsayılanlar kullanılarak hesaplanır (örneğin, `generate_audio` varsayılanı `true` olan bir video modeli,
`"generate_audio": false` göndermediğiniz sürece ses dahil fiyatlandırılır).

## Dosya parametreleri

Görüntü, video ve ses parametreleri herkese açık bir URL, en fazla 10 MB boyutunda bir `data:` URI'si veya yüklenen
bir dosyanın `file_url` değerini kabul eder. [Dosyalar](https://doitong.com/developers/docs/files) sayfasına bakın.