# Paramedrau

Mae pob model yn cadw ei enwau paramedrau brodorol, ac mae pob tudalen model yn eu rhestru. Yn ogystal â hynny, mae'r API yn derbyn
**enwau canonaidd** ar gyfer y paramedrau sy'n golygu'r un peth ar bob model, felly mae cod a ysgrifennwyd ar gyfer un model yn gweithio
ar y model nesaf gyda llai o newidiadau.

## Enwau canonaidd

| Enw canonaidd | Ystyr | Enwau brodorol nodweddiadol |
|---|---|---|
| `image` | Y ddelwedd fewnbwn neu'r ddelwedd ffrâm gyntaf | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | Delwedd y ffrâm olaf | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | Rhestr o ddelweddau cyfeirio | `image_urls`, `reference_image_urls` |
| `video` | Y fideo mewnbwn | `video_url` |
| `videos` | Rhestr o fideos cyfeirio | `video_urls` |
| `audio` | Y sain fewnbwn | `audio_url` |
| `audios` | Rhestr o glipiau sain cyfeirio | `audio_urls` |
| `mask` | Delwedd fasg | `mask_url` |
| `num_outputs` | Faint o ganlyniadau i'w cynhyrchu | `num_images` |
| `generate_audio` | Cynhyrchu sain gyda'r fideo | `generate_audio_switch`, `enable_audio` |

I ba faes brodorol y mae enw canonaidd yn mapio ar bob model cyfredol:

| Enw canonaidd | Maes brodorol (modelau sy’n ei ddefnyddio) |
|---|---|
| `audio` | `audio_url` (modelau: 126) |
| `audios` | `audio_urls` (modelau: 7), `reference_audio_urls` (modelau: 1) |
| `end_image` | `end_image_url` (modelau: 76), `last_frame_url` (modelau: 12), `tail_image_url` (modelau: 1) |
| `generate_audio` | `generate_audio_switch` (modelau: 16), `audio` (modelau: 3) |
| `image` | `image_url` (modelau: 529), `start_image_url` (modelau: 20), `first_frame_url` (modelau: 12), `first_image_url` (modelau: 7), `source_image_url` (modelau: 2) |
| `images` | `image_urls` (modelau: 148), `reference_image_urls` (modelau: 31) |
| `mask` | `mask_url` (modelau: 46) |
| `num_outputs` | `num_images` (modelau: 337) |
| `video` | `video_url` (modelau: 197) |
| `videos` | `video_urls` (modelau: 13), `reference_video_urls` (modelau: 1) |

Rheolau:

- Anfonwch naill ai'r enw canonaidd neu'r enw brodorol. Os anfonwch y ddau â gwerthoedd gwahanol, bydd yr alwad yn methu gyda
  `422 invalid_input` ar yr enw canonaidd.
- Caiff paramedr nad yw'n enw brodorol nac yn enw canonaidd y model ei wrthod gyda `422 invalid_input`
  ("Unknown parameter"), ynghyd â'r enw dilys agosaf fel awgrym. Nid yw teipos byth yn pasio'n dawel.
- Mae pob tudalen model yn dangos y ddau enw ochr yn ochr.

## Gorfodi mathau

Caiff gwerthoedd eu trosi i'r math y mae'r model yn ei ddisgwyl, felly mae'r rhain i gyd yn gweithio:

| Rydych yn anfon | Mae'r model yn disgwyl | Yn dod yn |
|---|---|---|
| `5`, `"5"`, `"5s"` | `duration` fel llinyn megis `"5"` | `"5"` |
| `"8"` | cyfanrif | `8` |
| `"1080P"`, `"4K"` | `resolution` megis `"1080p"`, `"4k"` | yr sillafiad union a ganiateir |
| `"true"`, `"false"`, `1`, `0` | gwerth Booleaidd | `true`, `false` |
| `"https://…/a.jpg"` | rhestr o URLs | `["https://…/a.jpg"]` |
| `42` | llinyn | `"42"` |

Caiff gwerthoedd a ganiateir eu paru'n union yn gyntaf, yna gan anwybyddu llythrennau mawr a bach, ac yna fel rhifau (`5` yn paru â gwerthoedd yn arddull `"5"`, `"5s"` a
`"5 s"`).

## Rhagosodiadau

Mae paramedrau rydych yn eu hepgor yn defnyddio rhagosodiad y model, a restrir yn nhabl paramedrau'r model. Cyfrifir y pris
gan ddefnyddio'r un rhagosodiadau (er enghraifft, mae model fideo y mae `generate_audio` yn rhagosod i `true` yn cael ei brisio gyda
sain oni bai eich bod yn anfon `"generate_audio": false`).

## Paramedrau ffeiliau

Mae paramedrau delwedd, fideo a sain yn derbyn URL cyhoeddus, URI `data:` hyd at 10 MB, neu `file_url` uwchlwythiad.
Gweler [Ffeiliau](https://doitong.com/developers/docs/files).