مفاتيح API
تتطلب جميع طلبات LemonData API مفتاح API.
بالنسبة إلى نقاط النهاية المتوافقة مع OpenAI، أرسله بالشكل التالي:
Authorization: Bearer sk-your-api-key
/v1/messages المتوافقة مع Anthropic، يمكنك أيضًا استخدام:
x-api-key: sk-your-api-key
الحصول على مفتاح API الخاص بك
- سجّل الدخول إلى لوحة تحكم LemonData
- افتح API Keys
- أنشئ مفتاحًا جديدًا
- امنحه اسمًا وصفيًا
- انسخه فورًا لأنه يُعرض مرة واحدة فقط
- لا تكشف أبدًا عن مفاتيح API في كود جهة العميل
- لا تقم أبدًا بإيداع مفاتيح API في نظام التحكم بالإصدارات
- استخدم متغيرات البيئة أو مدير الأسرار
- قم بتدوير المفاتيح بشكل دوري
- احذف المفاتيح غير المستخدمة
استخدام مفاتيح API
curl https://api.lemondata.cc/v1/responses \
-H "Authorization: Bearer $LEMONDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"input": "Hello!"
}'
ميزات مفتاح API
حدود الاستخدام
يمكنك تعيين حد استخدام لكل مفتاح API:
| الإعداد | الوصف |
|---|
| بدون حد | يستخدم المفتاح رصيد حسابك دون قيود |
| حد ثابت | يتوقف المفتاح عن العمل بعد الوصول إلى المبلغ المحدد |
بادئة المفتاح
تبدأ جميع مفاتيح LemonData API بـ sk-.
التوافق مع Anthropic
بالنسبة إلى نقطة النهاية /v1/messages، يعمل ترويس Anthropic كما هو متوقع:
curl https://api.lemondata.cc/v1/messages \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
استخدم Authorization: Bearer ... لنقاط النهاية المتوافقة مع OpenAI مثل /v1/responses و/v1/chat/completions و/v1/models ومعظم مسارات LemonData الأخرى.
استجابات الأخطاء
| رمز الحالة | النوع | الرمز | الوصف |
|---|
| 401 | invalid_request_error | invalid_api_key | مفتاح API مفقود أو غير صالح |
| 401 | invalid_request_error | expired_api_key | تم إلغاء مفتاح API |
| 402 | insufficient_quota | insufficient_quota | رصيد الحساب غير كافٍ |
| 402 | insufficient_quota | quota_exceeded | تم الوصول إلى حد استخدام مفتاح API |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
