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

​
نظرة عامة

إن LemonData API متوافق مع OpenAI، مما يعني أنه يمكنك استخدام OpenAI SDK الرسمي بمجرد تغيير URL الأساسي. كما ندعم أيضاً تنسيقات طلبات Anthropic و Gemini الأصلية.

​
URL الأساسي

https://api.lemondata.cc

​
المصادقة

تتطلب جميع نقاط نهاية API المصادقة باستخدام Bearer token: 
Authorization: Bearer sk-your-api-key
احصل على مفتاح API الخاص بك من لوحة التحكم.

​
نقاط النهاية المدعومة

​
الدردشة وتوليد النصوص

نقطة النهايةالطريقةالوصف
/v1/chat/completionsPOSTإكمال الدردشة المتوافق مع OpenAI
/v1/messagesPOSTAPI الرسائل المتوافق مع Anthropic
/v1/responsesPOSTOpenAI Responses API

​
التضمينات (Embeddings) وإعادة التصنيف (Rerank)

نقطة النهايةالطريقةالوصف
/v1/embeddingsPOSTإنشاء تضمينات النصوص
/v1/rerankPOSTإعادة تصنيف المستندات

​
الصور

نقطة النهايةالطريقةالوصف
/v1/images/generationsPOSTتوليد الصور من النصوص
/v1/images/editsPOSTتعديل الصور

​
الصوت

نقطة النهايةالطريقةالوصف
/v1/audio/speechPOSTتحويل النص إلى كلام (TTS)
/v1/audio/transcriptionsPOSTتحويل الكلام إلى نص (STT)

​
الفيديو

نقطة النهايةالطريقةالوصف
/v1/videos/generationsPOSTإنشاء مهمة توليد فيديو
/v1/videos/generations/{id}GETالحصول على حالة مهمة الفيديو

​
الموسيقى

نقطة النهايةالطريقةالوصف
/v1/music/generationsPOSTإنشاء مهمة توليد موسيقى
/v1/music/generations/{id}GETالحصول على حالة مهمة الموسيقى

​
توليد ثلاثي الأبعاد (3D)

نقطة النهايةالطريقةالوصف
/v1/3d/generationsPOSTإنشاء مهمة توليد نموذج ثلاثي الأبعاد
/v1/3d/generations/{id}GETالحصول على حالة مهمة 3D

​
النماذج

نقطة النهايةالطريقةالوصف
/v1/modelsGETقائمة بجميع النماذج المتاحة
/v1/models/{model}GETالحصول على معلومات نموذج محدد

​
تنسيق الاستجابة

تتبع جميع الاستجابات تنسيقاً ثابتاً:

​
استجابة النجاح

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​
شفافية التوجيه (Routing)

تتضمن جميع الاستجابات حقل _routing مع معلومات القناة: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
الحقلالوصف
channel.idمعرف القناة المستخدم
channel.providerالمزود الرئيسي (openai، anthropic، إلخ.)
channel.channelTypePLATFORM (LemonData) أو PRIVATE (BYOK)
cachedما إذا كانت الاستجابة قد تمت خدمتها من التخزين المؤقت (cache)
retryCountعدد محاولات إعادة المحاولة (إن وجدت)

​
استجابة الخطأ

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

​
حدود المعدل (Rate Limits)

تعتمد حدود المعدل على الأدوار وهي قابلة للتكوين من قبل المسؤولين. القيم الافتراضية:
الدورالطلبات/الدقيقة
مستخدم60
شريك300
VIP1,000
مسؤولغير محدود
اتصل بالدعم للحصول على حدود معدل مخصصة. قد تختلف القيم الدقيقة حسب تكوين الحساب.
يتم تضمين رؤوس (headers) حدود المعدل في جميع الاستجابات: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1234567890

​
مواصفات OpenAPI

مواصفات OpenAPI

قم بتنزيل مواصفات OpenAPI 3.0 الكاملة