الحدود والرصيد

تشرح هذه الصفحة مما يتكوّن رصيدك، وما الذي يحجزه الطلب الواحد وكم يكلّف، وكم طلباً يمكنك إرساله، والحدود القليلة التي قد يواجهها الطلب الواحد.

قيمة 1M token من الرصيد

$5.00

تجدد المخصص اليومي

00:00 UTC

الحماية من الإغراق، لكل حساب

120 طلب / دقيقة

كيف تُخدَّم الطلبات

• لا شرائح لمعدل الطلبات — قاعدة واحدة تحدد سرعة وصول الطلبات، وهي نفسها لكل حساب ولكل خطة: 120 طلباً في الدقيقة. ولا حد على الـ tokens في الدقيقة.
• لا حصة API منفصلة — تُنفق API الرصيد نفسه الذي تنفقه الدردشة. وتحدد الخطة حجم مخصصات اليوم، ولا تحدد معدل الطلبات.
• بالسرعة التي تشاء — الطلبات المرسلة بالتوازي تُقبل وتنتظر في الطابور. ولا تُرفض لمجرد أنها متوازية.

رصيدك

يُحسب رصيدك بالـ tokens. وقيمة 1,000,000 token من الرصيد تساوي $5.00، وكل سعر في صفحة Models & pricing هو معدل مقابل هذه القيمة.

في أي لحظة يكون الرصيد مجموع جزأين.

• مخصصات الخطة لليوم — عدد من الـ tokens تحدده خطتك. يتجدد كل يوم عند 00:00 UTC. وما يتبقى في نهاية اليوم لا يُرحَّل.
• الرصيد المشتري — الـ tokens التي اشتريتها كحزمة. لا تنتهي صلاحية الرصيد، ويعمل مع كل خطة، بما فيها Free.

• ترتيب الإنفاق — يُنفق كل طلب مخصصات الخطة لليوم أولاً. ولا يُستخدم الرصيد المشتري إلا لما يتجاوز المخصصات في ذلك اليوم.
• الدردشة وAPI يتشاركانه — يوجد رصيد واحد لكل حساب. ويُنفق مفتاح API من رصيد الحساب الذي يملكه، بالأسعار نفسها المعتمدة في الدردشة.
• الحزم — يُباع الرصيد في حزم من 1,000,000 ($5.00) و2,000,000 ($10.00) و5,000,000 ($25.00) token، أو بمبلغ تختاره من 1,000,000 إلى 100,000,000 token بسعر $5.00 لكل 1,000,000.

شحن الرصيد تغيير الخطة

ما يحجزه الطلب وما يكلّفه

• الحجز — عند وصول الطلب يحجز ميزانية مخرجاته من رصيدك: max_tokens على /v1/chat/completions و/v1/messages، وmax_output_tokens على /v1/responses. كما يقرأ /v1/chat/completions الحقل max_completion_tokens. القيمة الافتراضية 4,096 والمدى من 1 إلى 65,536.
• القبول — يُقبل الطلب فقط إذا كان الحجز ضمن ما تبقى من رصيدك. والرصيد الذي يزيد على الصفر لكنه أقل من ميزانية المخرجات يحصل على الرد Quota exceeded. أرسل max_tokens أصغر لاستخدام المتبقي.
• التسوية — عند اكتمال الإجابة يُستبدل الحجز بالتكلفة الفعلية. وقد تكون التكلفة أقل من الحجز أو أعلى منه.
• الإرجاع — الطلب الذي ينتهي بحالة خطأ يُعاد حجزه كاملاً.

تعتمد التكلفة الفعلية على عائلة النموذج.

يُخصم المبلغ بالدولار من رصيدك بالـ tokens بسعر $5.00 لكل 1,000,000، مقرباً إلى token كامل.

عدّ الـ tokens عبر POST /v1/tokenize أو POST /v1/messages/count_tokens مجاني ولا يحجز شيئاً. عدّ الـ tokens

أين ترى الرصيد والاستخدام

تعرض صفحة Keys & usage ما يمكنك إنفاقه الآن، ومخصصات الخطة لليوم، ورصيدك المشتري، وإنفاق API خلال آخر 30 يوماً. وتحتها قائمة بكل طلب أرسله مفتاحك: الوقت ونقطة النهاية والنموذج والمدخلات المخبأة والـ tokens المحتسبة والتكلفة. المفاتيح والاستخدام

يحمل كل رد أيضاً كائن usage فيه عدد الـ tokens لتلك المكالمة.

• يحتوي usage على عدد الـ tokens التي استخدمها النموذج. أما المقدار المخصوم من رصيدك فليس في الرد: إنه العمود tokens المحتسبة في قائمة الطلبات في Keys & usage.
• على /v1/messages مع نموذج مفتوح الأوزان مستضاف، يمثل input_tokens الجزء غير المخبأ من المدخلات، ويمثل cache_read_input_tokens الجزء المخبأ، ويكون cache_creation_input_tokens دائماً 0.
• يحمل البث على /v1/chat/completions الكائن usage في آخر جزء قبل [DONE]. البث

عند نفاد الرصيد

الطلب الذي لا يتسع حجزه في رصيدك يُجاب عنه بالحالة 429 والنوع rate_limit_error والرسالة أدناه. ولا يُحتسب شيء. ويُرسل الرد نفسه عندما يكون الرصيد أكبر من الصفر لكنه أقل من ميزانية مخرجات الطلب.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Quota exceeded. Upgrade your plan at shannon-ai.com/plan"
  }
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Quota exceeded. Upgrade your plan at shannon-ai.com/plan"
  }
}

على /v1/responses قد يحتوي الكائن error أيضاً على code وparam، وكلاهما null.

ما يمكنك فعله:

• انتظر مخصصات الخطة التالية عند 00:00 UTC.
• اشحن الرصيد. يُنفق الرصيد بعد مخصصات الخطة ولا تنتهي صلاحيته. شحن الرصيد
• انتقل إلى خطة ذات مخصص يومي أكبر. تغيير الخطة
• أرسل max_tokens أصغر إن بقي بعض الرصيد: فيصبح الحجز أصغر.

حصة مكالمات Shannon Coder

يُحتسب shannon-coder-1 على /v1/chat/completions و/v1/messages بالمكالمات لا بالـ tokens. تتضمن كل خطة عدداً من المكالمات لكل نافذة مدتها 4 ساعات. والطلب الواحد مكالمة واحدة.

• تبدأ النوافذ عند 00:00, 04:00, 08:00, 12:00, 16:00, 20:00 UTC. والمكالمات المتبقية في نهاية النافذة لا تُرحَّل.
• تُحسب المكالمة عند قبول الطلب، قبل أن يجيب النموذج. والطلب الذي يفشل بعد ذلك يُحسب مكالمة أيضاً.
• هذه المكالمات لا تحجز أي tokens ولا تخصم شيئاً من رصيدك. وتعرض قائمة الطلبات في Keys & usage عدد الـ tokens وقيمتها بالسعر المعلن.
• القيمة الافتراضية لـ max_tokens في shannon-coder-1 على نقطتي النهاية هاتين هي 65,536.
• عند نفاد المكالمات يكون الرد بالحالة 429 والنوع rate_limit_error والرسالة Shannon Coder call quota reached. Upgrade your plan at shannon-ai.com/plan.
• على /v1/responses لا توجد حصة مكالمات لـ shannon-coder-1: بل يُحاسَب بالـ tokens من رصيدك بسعر $8.00 لكل 1M، مثل كل نموذج آخر.

الحماية من الإغراق

يستطيع الحساب إرسال 120 طلباً في الدقيقة. وهذا هو الحد الوحيد على معدل الطلبات، وهو نفسه في كل خطة. وُجد لمنع الإغراق، لا لإبطاء الاستخدام العادي.

• الدقيقة نافذة ثابتة مدتها 60 ثانية تبدأ مع أول طلب لك. وعند انتهائها يبدأ العد من الصفر من جديد.
• العد يكون لكل حساب، لا لكل مفتاح ولا لكل عنوان IP. تدوير المفتاح لا يفتح نافذة جديدة.
• الطلب رقم 121 داخل النافذة يُجاب عنه بالحالة 429 والنوع rate_limit_error والرسالة Too many requests. Retry in <N>s. وتمثل N عدد الثواني حتى نهاية النافذة، من 1 إلى 60.
• تُفحص الحماية من الإغراق قبل الرصيد. والطلب الذي ترفضه لا يحجز شيئاً ولا يكلّف شيئاً.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Too many requests. Retry in 37s."
  }
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Too many requests. Retry in 37s."
  }
}

الطلبات المتوازية

لا حد لعدد الطلبات التي يفتحها الحساب في الوقت نفسه، ولا خطأ عند إرسال الطلبات بالتوازي. والطلبات التي لا يمكن أن تبدأ فوراً تنتظر في الطابور ويُجاب عنها بالتتابع.

• يُحتسب كل طلب ضمن الـ 120 في الدقيقة عند وصوله، سواء انتهت الطلبات السابقة أم لا.
• يحتفظ كل طلب بحجزه الخاص حتى ينتهي. عشرون طلباً مفتوحاً بميزانية المخرجات الافتراضية تحجز 20 × 4,096 = 81,920 token من الرصيد. وإذا كانت الحجوزات معاً أكبر من رصيدك، يحصل الطلب التالي على الرد Quota exceeded، حتى لو كانت المكالمات المنتهية ستكلّف أقل. وmax_tokens أصغر يحجز أقل.
• الطلب بدون بث لا يرسل شيئاً حتى تكتمل إجابته، فاضبط في عميلك مهلة تغطي الانتظار. أما البث فيُبقي اتصاله مفتوحاً أثناء الانتظار. البث

حدود الطلب الواحد

الأخطاء

ردود هذه الصفحة. على /v1/messages يُغلَّف الكائن error نفسه هكذا {"type": "error", "error": {…}}.