الحدود
حدود معدل الطلبات في Direct API، والترويسات التي تُبلغ عنها، وحدود الحجم والعدد.
معدل الطلبات
| الحصة | الحد | يُحتسب لكل |
|---|---|---|
| قراءات عمليات التوليد | 30 في الدقيقة لكل عملية توليد، و1,200 في الدقيقة إجمالًا | مفتاح API |
استدعاءات الأدوات المجانية (القوائم، الكتالوج، plan_media، وكل عنوان URL لوسائط يستوردها الاستدعاء) | 1,000 في الساعة | مفتاح API |
إدارة الويبهوك (/webhooks ومساراته) | 60 في الدقيقة | مفتاح API |
/usage، /me | 60 في الدقيقة | مفتاح API |
الطلبات التي لا يعمل مفتاح API الخاص بها (401) | 60 لكل 10 دقائق؛ بعد تجاوزها تُجيب الطلبات الواردة من ذلك العنوان بـ 429 (مع Retry-After) حتى تنتهي النافذة، إلا إذا كان المفتاح قد اجتاز المصادقة خلال آخر 10 دقائق | عنوان IP للعميل (يُحتسب عنوان IPv6 بنطاق /64 الخاص به) |
| استدعاءات الأدوات المدفوعة | لا يوجد حد لمعدل الطلبات |
- الاستدعاءات المدفوعة مقيّدة بالمال لا بالمعدل: حدود الرصيد لمفتاحك ورصيد مؤسستك.
- تحت الضغط الشديد، تنتظر عملية التوليد في
queuedحتى تتوفر سعة النموذج بدلًا من أن تُرفض. وبدء عمل يفوق ما يستطيع النموذج تشغيله في آن واحد يجعل عمليات التوليد اللاحقة تستغرق وقتًا أطول، لكنها لا تفشل أبدًا. - الاستدعاء المدفوع الذي تبيّن أن نتيجته مجانية، مثل
video_remove_audioعلى فيديو صامت، يُحتسب ضمن حصة الاستدعاءات المجانية.
استجابات حد المعدل
تعيد كل نقطة نهاية خاضعة لحد المعدل هذه الترويسات:
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760يُجاب الطلب المرفوض بـ 429 مع Retry-After: <seconds> وهذا الجسم:
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}انتظر عدد الثواني المحدد في Retry-After قبل إعادة المحاولة. ولا يخصم 429 أي شيء أبدًا.
حدود الحجم والعدد
| الحد | القيمة |
|---|---|
| جسم الطلب | 1 MB |
variations لكل بدء صورة | من 1 إلى 4 |
| المعرّفات في القراءة المجمّعة | 10 |
wait | 45 ثانية |
metadata | 20 مفتاحًا؛ المفتاح حتى 40 حرفًا، والقيمة حتى 500 |
Idempotency-Key | حتى 200 حرف، يُحفظ 24 ساعة |
| مفاتيح API النشطة لكل مؤسسة | 10 |
| نقاط نهاية الويبهوك لكل مؤسسة | 10 |
| مدة صلاحية رابط الأصل | بلا انتهاء صلاحية |
| مدخلات كل نموذج (طول الموجّه، الصور المرجعية، المدد، أحجام الملفات) | كما هو مذكور في النماذج وفي input_schema لكل أداة |
إذا واجهت أي مشكلة أو كانت لديك أي أسئلة، فلا تتردد في التواصل معنا. يسعدنا مساعدتك. اكتب لنا على support@morphic.com.