# المعلمات

يحتفظ كل نموذج بأسماء معلماته الأصلية، وتسردها صفحة كل نموذج. بالإضافة إلى ذلك، تقبل 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"` | `duration` كسلسلة مثل `"5"` | `"5"` |
| `"8"` | عدد صحيح | `8` |
| `"1080P"`, `"4K"` | `resolution` مثل `"1080p"`, `"4k"` | الصيغة المسموح بها بالضبط |
| `"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 عامًا، أو URI من نوع `data:` بحجم يصل إلى 10 MB، أو `file_url` لملف
مرفوع. راجع [الملفات](https://doitong.com/developers/docs/files).