# அளவுருக்கள்

ஒவ்வொரு மாடலும் அதன் சொந்த அளவுருப் பெயர்களைப் பயன்படுத்துகிறது; ஒவ்வொரு மாடல் பக்கமும் அவற்றைப் பட்டியலிடுகிறது. இதற்கு மேலாக, ஒவ்வொரு மாடலிலும் ஒரே பொருளைக் குறிக்கும் அளவுருக்களுக்கு API **நிலையான பெயர்களை** ஏற்றுக்கொள்கிறது. இதனால் ஒரு மாடலுக்காக எழுதப்பட்ட குறியீட்டை அடுத்த மாடலிலும் குறைந்த மாற்றங்களுடன் பயன்படுத்தலாம்.

## நிலையான பெயர்கள்

| நிலையான பெயர் | பொருள் | வழக்கமான சொந்தப் பெயர்கள் |
|---|---|---|
| `image` | உள்ளீட்டு அல்லது முதல்-ஃப்ரேம் படம் | `image_url`, `start_image_url`, `first_frame_url`, `first_image_url`, `source_image_url` |
| `end_image` | கடைசி-ஃப்ரேம் படம் | `end_image_url`, `last_frame_url`, `tail_image_url` |
| `images` | குறிப்புப் படங்களின் பட்டியல் | `image_urls`, `reference_image_urls` |
| `video` | உள்ளீட்டு வீடியோ | `video_url` |
| `videos` | குறிப்பீட்டு வீடியோக்களின் பட்டியல் | `video_urls` |
| `audio` | உள்ளீட்டு ஆடியோ | `audio_url` |
| `audios` | குறிப்பீட்டு ஆடியோ கிளிப்களின் பட்டியல் | `audio_urls` |
| `mask` | முகமூடிப் படம் | `mask_url` |
| `num_outputs` | உருவாக்க வேண்டிய முடிவுகளின் எண்ணிக்கை | `num_images` |
| `generate_audio` | வீடியோவுடன் ஒலியை உருவாக்கு | `generate_audio_switch`, `enable_audio` |

தற்போதைய ஒவ்வொரு மாடலிலும் ஒரு நிலையான பெயர் எந்த சொந்தப் புலத்துடன் இணைகிறது:

| நியமப் பெயர் | நேட்டிவ் புலம் (இதைப் பயன்படுத்தும் மாடல்கள்) |
|---|---|
| `audio` | `audio_url` (மாடல்கள்: 126) |
| `audios` | `audio_urls` (மாடல்கள்: 7), `reference_audio_urls` (மாடல்கள்: 1) |
| `end_image` | `end_image_url` (மாடல்கள்: 76), `last_frame_url` (மாடல்கள்: 12), `tail_image_url` (மாடல்கள்: 1) |
| `generate_audio` | `generate_audio_switch` (மாடல்கள்: 16), `audio` (மாடல்கள்: 3) |
| `image` | `image_url` (மாடல்கள்: 529), `start_image_url` (மாடல்கள்: 20), `first_frame_url` (மாடல்கள்: 12), `first_image_url` (மாடல்கள்: 7), `source_image_url` (மாடல்கள்: 2) |
| `images` | `image_urls` (மாடல்கள்: 148), `reference_image_urls` (மாடல்கள்: 31) |
| `mask` | `mask_url` (மாடல்கள்: 46) |
| `num_outputs` | `num_images` (மாடல்கள்: 337) |
| `video` | `video_url` (மாடல்கள்: 197) |
| `videos` | `video_urls` (மாடல்கள்: 13), `reference_video_urls` (மாடல்கள்: 1) |

விதிகள்:

- நிலையான பெயர் அல்லது சொந்தப் பெயர் ஆகியவற்றில் ஒன்றை மட்டும் அனுப்பவும். இரண்டையும் வெவ்வேறு மதிப்புகளுடன் அனுப்பினால், நிலையான பெயரில் `422 invalid_input` என்ற பிழையுடன் அழைப்பு தோல்வியடையும்.
- மாடலின் சொந்தப் பெயராகவோ நிலையான பெயராகவோ இல்லாத அளவுரு `422 invalid_input` ("Unknown parameter") என்ற பிழையுடன் நிராகரிக்கப்படும்; அதனுடன் மிக நெருக்கமான செல்லுபடியாகும் பெயர் பரிந்துரைக்கப்படும். எழுத்துப் பிழைகள் ஒருபோதும் அமைதியாக ஏற்கப்படாது.
- ஒவ்வொரு மாடல் பக்கமும் இரு பெயர்களையும் அருகருகே காட்டுகிறது.

## வகை மாற்றம்

மாடல் எதிர்பார்க்கும் வகைக்கு ஏற்ப மதிப்புகள் மாற்றப்படுகின்றன; எனவே இவை அனைத்தும் செயல்படும்:

| நீங்கள் அனுப்புவது | மாடல் எதிர்பார்ப்பது | ஆக மாறுவது |
|---|---|---|
| `5`, `"5"`, `"5s"` | `"5"` போன்ற ஒரு சரமாக `duration` | `"5"` |
| `"8"` | ஒரு முழு எண் | `8` |
| `"1080P"`, `"4K"` | `"1080p"`, `"4k"` போன்ற `resolution` | அனுமதிக்கப்பட்ட சரியான எழுத்தாக்கம் |
| `"true"`, `"false"`, `1`, `0` | ஒரு பூலியன் | `true`, `false` |
| `"https://…/a.jpg"` | URL-களின் பட்டியல் | `["https://…/a.jpg"]` |
| `42` | ஒரு சரம் | `"42"` |

அனுமதிக்கப்பட்ட மதிப்புகள் முதலில் சரியாகப் பொருத்தப்படுகின்றன; பின்னர் எழுத்து வடிவ வேறுபாடுகளைப் புறக்கணித்து, அதன் பிறகு எண்களாகப் பொருத்தப்படுகின்றன (`5` என்பது `"5"`, `"5s"`, `"5 s"` போன்ற மதிப்புகளுடன் பொருந்தும்).

## இயல்புநிலைகள்

நீங்கள் விடுக்கும் அளவுருக்கள் மாடலின் இயல்புநிலையைப் பயன்படுத்தும்; அது மாடலின் அளவுரு அட்டவணையில் பட்டியலிடப்பட்டுள்ளது. விலையும் அதே இயல்புநிலைகளைப் பயன்படுத்திக் கணக்கிடப்படும் (எடுத்துக்காட்டாக, `generate_audio` இயல்புநிலையாக `true` ஆக உள்ள வீடியோ மாடலுக்கு, `"generate_audio": false` என்று அனுப்பாத வரை ஒலியுடன் கூடிய விலையே கணக்கிடப்படும்).

## கோப்பு அளவுருக்கள்

படம், வீடியோ மற்றும் ஆடியோ அளவுருக்கள் பொது URL, 10 MB வரை உள்ள `data:` URI அல்லது பதிவேற்றத்தின் `file_url` ஆகியவற்றை ஏற்கும். [Files](https://doitong.com/developers/docs/files) என்பதைப் பார்க்கவும்.