Gemini الأصلي

حساب الرموز (Count Tokens)

حساب الرموز (tokens) المدخلة لطلب Gemini دون توليد محتوى أو احتساب تكاليف.

POST
/v1beta/models/{model}:countTokens

حساب الرموز (tokens) المدخلة لطلب Gemini قبل إرساله. هذا الاستدعاء لا يتم محاسبتك عليه ولا يتطلب رصيداً في الحساب، ولكنه يتطلب مفتاح API. استخدمه مع نموذج يدرج countTokens ضمن supportedGenerationMethods في استجابة الحصول على النموذج.

أرسل إما contents أو generateContentRequest كامل. استخدم العدد للتخطيط؛ حيث تأتي تكلفة طلب التوليد من usageMetadata الخاصة بتلك الاستجابة.

المصادقة (Authentication)

نفس طريقة إنشاء المحتوى: ?key= أو x-goog-api-key أو Authorization: Bearer.

جسم الطلب (Request Body)

contentsarray

محتويات المحادثة بنفس شكل إنشاء المحتوى.

generateContentRequestobject

طلب توليد Gemini كامل لحسابه، كبديل لـ contents. يتم قبول generate_content_request أيضاً.

الأخطاء (Errors)

  • 400 INVALID_ARGUMENT: جسم الطلب غير صالح، أو أن النموذج لا يقبل طلبات Gemini.
  • 401 UNAUTHENTICATED: مفتاح API مفقود أو غير صالح.
  • 503 UNAVAILABLE: لا يوجد مسار متاح للنموذج في الوقت الحالي. حاول مرة أخرى لاحقاً.

الطلب

cURL
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:countTokens" \
  -H "x-goog-api-key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ]
  }'

الاستجابة

200 OK
{
  "totalTokens": 7
}
totalTokensinteger
عدد الرموز (tokens) المدخلة في الطلب.

التفويض

AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات المسار

model*string

اسم النموذج (مثال: gemini-2.5-pro)

معاملات الاستعلام

key?string

مفتاح API (بديل لمصادقة الرأس)

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json