الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

يدعم TokenLab تنسيق Google Gemini API الأصلي لنماذج Gemini. يتيح ذلك التوافق المباشر مع Google AI SDKs.

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

​
model
string
مطلوب
اسم النموذج (على سبيل المثال، gemini-2.5-pro، gemini-2.5-flash).للتكاملات الإنتاجية، فضّل أجزاء الوسائط المعتمدة على URL من fileData / file_data مع عنوان URL عام يبدأ بـ https. سيوجه TokenLab القنوات الأصلية المدعومة من Gemini عبر المسار الأصلي عندما يكون ذلك ممكنًا، وسيتراجع تلقائيًا إلى مسار التحويل الداخلي المتوافق عندما لا يتوفر مسار جاهز أصليًا لذلك الطلب متعدد الوسائط.

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

​
key
string
مفتاح API (بديل للمصادقة عبر الترويسة).

​
المصادقة

تدعم نقاط نهاية Gemini طرق مصادقة متعددة:
  • ?key=YOUR_API_KEY معلمة استعلام
  • x-goog-api-key: YOUR_API_KEY ترويسة
  • Authorization: Bearer YOUR_API_KEY ترويسة

​
جسم الطلب

​
contents
array
مطلوب
محتويات المحادثة.يحتوي كل كائن محتوى على:
  • role (string): user أو model
  • parts (array): أجزاء المحتوى. يدعم TokenLab حالياً:
    • أجزاء نصية: { "text": "..." }
    • أجزاء وسائط مضمّنة: inlineData / inline_data
    • أجزاء ملفات معتمدة على URL: fileData / file_data
بالنسبة إلى أجزاء الوسائط، يقبل TokenLab حالياً أنواع MIME الخاصة بالصور والصوت والفيديو ويمررها عبر العقد العام المتوافق مع Gemini.تتم مطابقة قيم الدور user وmodel بدون حساسية لحالة الأحرف. يتم قبول inlineData / inline_data مع application/octet-stream فقط عندما يستطيع TokenLab التعرف على بايتات صورة أو فيديو مدعومة؛ وإلا يفشل الطلب قبل التوجيه. في طلبات إخراج الصور الأصلية، تُقبل فقط عائلة أدوات Google search/maps، وتفشل تركيبات الأدوات غير المدعومة قبل إعادة المحاولة مع المزود.
​
systemInstruction
object
تعليمات النظام للنموذج.
​
generationConfig
object
تكوين الإنشاء:
  • temperature (number): درجة حرارة أخذ العينات
  • topP (number): احتمالية أخذ عينات النواة (Nucleus sampling)
  • topK (integer): أخذ عينات Top-K
  • maxOutputTokens (integer): الحد الأقصى لـ tokens المخرجات
  • stopSequences (array): تسلسلات التوقف
​
safetySettings
array
إعدادات فلاتر الأمان.

​
الاستجابة

​
candidates
array
مرشحو المحتوى الذي تم إنشاؤه.
​
usageMetadata
object
معلومات استخدام الـ token.
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{"text": "Hello, Gemini!"}]
      }
    ],
    "generationConfig": {
      "temperature": 0.7,
      "maxOutputTokens": 1024
    }
  }'

​
أمثلة الإدخال متعدد الوسائط

في طلبات Gemini متعددة الوسائط، ضع الوسائط داخل contents[].parts[] باستخدام بايتات مضمّنة أو مراجع ملفات عبر URL. فئات الوسائط المدعومة حالياً في العقد العام لـ Gemini:
  • صورة
  • صوت
  • فيديو
بالنسبة إلى الوسائط المضمّنة، استخدم inlineData أو inline_data ومرّر بايتات الملف بترميز Base64. بالنسبة إلى الوسائط عبر URL، استخدم fileData أو file_data ومرّر عنوان https عاماً يمكن الوصول إليه.

​
مثال إدخال صورة

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "يرجى وصف هذه الصورة." },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

​
مثال إدخال صوت

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "يرجى تفريغ هذا الصوت وتلخيصه." },
        {
          "file_data": {
            "mime_type": "audio/mpeg",
            "file_uri": "https://example.com/sample.mp3"
          }
        }
      ]
    }
  ]
}

​
مثال إدخال فيديو

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "يرجى وصف هذا الفيديو بإيجاز." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/sample.mp4"
          }
        }
      ]
    }
  ]
}

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Hello! How can I assist you today?"}
        ]
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 5,
    "candidatesTokenCount": 10,
    "totalTokenCount": 15
  }
}

​
مثال إدخال الفيديو

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this video." },
        {
          "fileData": {
            "mimeType": "video/mp4",
            "fileUri": "https://example.com/demo.mp4"
          }
        }
      ]
    }
  ]
}

​
مثال إدخال الصوت

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this audio." },
        {
          "fileData": {
            "mimeType": "audio/mpeg",
            "fileUri": "https://example.com/demo.mp3"
          }
        }
      ]
    }
  ]
}