المعلمات
يحتفظ كل نموذج بأسماء معلماته الأصلية، وتسردها صفحة كل نموذج. بالإضافة إلى ذلك، تقبل 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 لملف
مرفوع. راجع الملفات.