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

​
معلمات المسار (Path Parameters)

​
model
string
مطلوب
اسم النموذج (على سبيل المثال، gemini-2.5-pro، gemini-2.5-flash).For production integrations, prefer URL-based fileData / file_data media parts with a public https URL. LemonData will route supported Gemini-native channels through the native path when possible and automatically fall back to the compatible internal conversion path when a native-ready route is unavailable for that multimodal request.

​
معلمات الاستعلام (Query Parameters)

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

​
المصادقة

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

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

​
contents
array
مطلوب
محتويات المحادثة.يحتوي كل كائن محتوى على:
  • role (string): user أو model
  • parts (array): أجزاء المحتوى. يدعم LemonData حالياً:
    • أجزاء نصية: { "text": "..." }
    • أجزاء وسائط مضمّنة: inlineData / inline_data
    • أجزاء ملفات معتمدة على URL: fileData / file_data
بالنسبة إلى أجزاء الوسائط، يقبل LemonData حالياً أنواع MIME الخاصة بالصور والصوت والفيديو ويمررها عبر العقد العام المتوافق مع Gemini.
​
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.lemondata.cc/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:
  • image
  • audio
  • video
بالنسبة إلى الوسائط المضمّنة، استخدم 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
  }
}

​
Video Input Example

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

​
Audio Input Example

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