الانتقال إلى المحتوى الرئيسي
تُعلّم هذه المهارة وكيل البرمجة الخاص بك كيفية تكامل أكثر من 300 API للذكاء الاصطناعي من LemonData فقط عبر وصف ما تحتاجه. وهي مُجمّعة كمهارة مشتركة واحدة بنهج agent-first وتعمل مع أي وكيل برمجة يدعم ملفات المهارات أو القواعد.إن الـ API Agent-First — حتى إذا خمّن الوكيل اسم نموذج بشكل خاطئ، فإن استجابة الخطأ تخبره بالضبط كيف يُصلح ذلك.
توضح هذه الصفحة طبقة تغليف مهارة قابلة لإعادة الاستخدام، وليست طبقة توافق بروتوكولي. إذا كنت تحتاج إلى إعداد نقطة نهاية أو SDK أو عميل، فاستخدم صفحات التكامل المخصصة لتلك الأدوات.

​
كيف تعمل

  1. أنت تصف ما تحتاجه — “أريد استخدام GPT-4 في مشروع Python الخاص بي”
  2. يستدعي الوكيل الـ API — وقد يخمّن اسم نموذج أو نقطة نهاية
  3. إذا حدث أي خطأ — يعيد الـ API تلميحات منظّمة (did_you_mean, suggestions, retry_after)
  4. يقوم الوكيل بالتصحيح الذاتي — يقرأ التلميحات ويعيد المحاولة باستخدام المعلمات الصحيحة
  5. تحصل على كود يعمل — عادةً من المحاولة الأولى أو الثانية

​
التثبيت

استخدم أمر التثبيت canonical غير التفاعلي:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y
يؤدي ذلك إلى تثبيت المهارة المشتركة lemondata-api-integration من مستودع مهارات LemonData.إذا كانت أداتك لا تدعم أداة التثبيت، فانْسَخ المجلد skills/lemondata-api-integration/ من المستودع إلى دليل المهارات أو القواعد المشتركة في أداتك.

​
التحقق من التثبيت

اطلب من وكيل البرمجة الخاص بك: 
ما هي المهارات المتاحة؟
إذا رأيت lemondata-api-integration، فقد نجح التثبيت.

​
احصل على API Key الخاص بك

1

زيارة LemonData

انتقل إلى lemondata.cc
2

تسجيل الدخول

أنشئ حسابًا أو سجّل الدخول
3

الحصول على API Key

انتقل إلى Dashboard → API Keys وأنشئ مفتاحًا جديدًا
4

نسخ المفتاح

يبدأ مفتاحك بـ sk-... — احفظه بأمان
لا تحتاج إلى إعداد API Key مسبقًا. عند استخدام المهارة، سيطلب الوكيل مفتاحك ويُضمّنه في الكود الذي يتم إنشاؤه.

​
أمثلة

​
Chat Completion

أنت تقول: 
أريد استخدام GPT-4 في مشروع Python الخاص بي
يُنشئ الوكيل: 
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.lemondata.cc/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
إذا خمّن الوكيل اسم نموذج خاطئًا (مثل gpt5)، يعيد الـ API: 
{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.lemondata.cc/v1/models to list all available models."
  }
}
يقرأ الوكيل did_you_mean، ويصحح اسم النموذج، ثم يعيد المحاولة — وكل ذلك تلقائيًا.

​
إنشاء الصور

أنت تقول: 
Generate images with Flux in Node.js
يستدعي الوكيل API الصور، ويتعامل مع الأخطاء، ويُنشئ كودًا كاملًا مع منطق التنزيل والحفظ.

​
التعرّف على الكلام

أنت تقول: 
Integrate speech-to-text in my app
يُنشئ الوكيل كودًا باستخدام نقطة النهاية الصحيحة /v1/audio/transcriptions ومعالجة ملفات الصوت.

​
استرداد أخطاء Agent-First

تتضمن كل استجابة خطأ تلميحات منظّمة يمكن لأي وكيل برمجة تحليلها. راجع المرجع الكامل لـ Agent-First API للحصول على التفاصيل.
الخطأما الذي يعيده الـ APIما الذي يفعله الوكيل
اسم نموذج خاطئdid_you_mean + suggestionsيُصحح تلقائيًا ويعيد المحاولة
رصيد غير كافٍbalance_usd + suggestions أرخصينتقل إلى نموذج بسعر مناسب
النموذج غير متاحalternatives + retry_afterينتقل إلى نموذج متاح
تم تطبيق rate limitretry_after (بالثواني الدقيقة)ينتظر ويعيد المحاولة
السياق طويل جدًاsuggestions مع نماذج أكبرينتقل إلى نموذج بسياق أكبر

​
تحسين نقطة النهاية الأصلية

عند استدعاء /v1/chat/completions باستخدام نموذج Claude أو Gemini، يعيد الـ API ترويسات تحسين: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
ينتقل الوكيل تلقائيًا إلى نقطة النهاية الأصلية للحصول على أداء أفضل (بدون تحويل للتنسيق، وتفكير موسّع، وprompt caching).

​
اكتشاف النماذج

لا حاجة للبحث في الوثائق: 
# Machine-readable API overview
curl https://api.lemondata.cc/llms.txt

# List models by category
curl "https://api.lemondata.cc/v1/models?category=chat" -H "Authorization: Bearer sk-KEY"
curl "https://api.lemondata.cc/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Filter by capability
curl "https://api.lemondata.cc/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
الإمكانات المدعومة

النوعأمثلة
الدردشةGPT-5.4, Claude, Gemini, DeepSeek
إنشاء الصورMidjourney, Flux, Stable Diffusion
إنشاء الفيديوSora, Runway, Kling, Luma AI
إنشاء الموسيقىSuno
نماذج ثلاثية الأبعادTripo3D
الصوتText-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

​
أفضل الممارسات

أمان API Key

استخدم متغيرات البيئة. لا تقم أبدًا بتضمين المفاتيح في git أو كشفها في كود الواجهة الأمامية.

إدارة التكلفة

حدّد حدود الاستخدام في dashboard الخاصة بك. تحقّق من error.balance_usd لمراقبة التكاليف برمجيًا.

كن مباشرًا

قل “I want to generate images in Python” بدلًا من “Does LemonData have an image API?”

صِف السيناريو الخاص بك

“I’m building a chatbot with GPT-4” يمنح الوكيل سياقًا أكبر من “Use GPT-4”.

​
الأسئلة الشائعة

جرّب ذكر “LemonData” أو “LemonData API” في طلبك:
أريد استخدام LemonData لدمج GPT-4 في مشروعي
يعيد Agent-First API الخاص بـ LemonData تلميحات أخطاء منظّمة. إذا خمّن الوكيل اسم نموذج خاطئًا، يتضمن الخطأ did_you_mean مع الاسم الصحيح وsuggestions مع بدائل. يقرأ الوكيل هذه ويصحح تلقائيًا في المحاولة التالية.
أي وكيل برمجة يدعم أدلة المهارات أو القواعد المشتركة. عندما تكون أداة التثبيت مدعومة، يضع npx skills add المهارة المشتركة lemondata-api-integration تلقائيًا في الموقع الذي تم اكتشافه.
أعد تشغيل أداة التثبيت:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

​
الموارد

Agent-First API

المرجع الكامل لتلميحات الأخطاء المنظّمة

وثائق API

المرجع الكامل لـ API

النماذج

تصفّح جميع النماذج المتاحة وعددها أكثر من 300

llms.txt

نظرة عامة قابلة للقراءة آليًا على API لوكلاء الذكاء الاصطناعي
هل لديك أسئلة؟ اطّلع على GitHub Issues الخاصة بنا أو تواصل مع [email protected]