مرجع API
وثائق API شاملة لمنصة LyDian Enterprise AI. جميع نقاط النهاية والمعاملات وأمثلة الاستخدام.
المصادقة
تتطلب جميع طلبات API مصادقة برمز Bearer. استخدم رمزك في ترويسة authorization.
curl -X GET https://www.ailydian.com/api/models \ -H "Authorization: Bearer sk-lydian-xxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json"
- لا تشارك مفتاح API الخاص بك أبدًا في المستودعات العامة
- خزّنه في متغيرات البيئة
- لا تستخدمه في الكود من جانب العميل
- جدّد مفاتيحك بشكل دوري
ينشئ محادثة مع نماذج AI. يمكنك الاختيار من بين 23 نموذجًا مختلفًا.
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
| message | string | نعم | رسالة المستخدم |
| model | string | لا | النموذج المراد استخدامه (الافتراضي: LyDian Engine) |
| stream | boolean | لا | وضع البث (الافتراضي: false) |
| temperature | number | لا | النطاق 0-1، مستوى الإبداع |
const response = await fetch('https://www.ailydian.com/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'yapay zeka nedir?',
model: 'LyDian Engine',
temperature: 0.7
})
});
const data = await response.json();
// DEBUG: console.log(data.response);
{
"success": true,
"response": "yapay zeka, makinelerin insan benzeri...",
"model": "LyDian Engine",
"tokens": 156,
"timestamp": "2024-01-15T10:30:00Z"
}
احصل على الردود مع البث في الوقت الفعلي. يتم عرضها فورًا عند وصول كل رمز.
const response = await fetch('https://www.ailydian.com/api/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'uzun bir makale yaz',
stream: true
})
});
const reader = response.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
const chunk = decoder.decode(value);
process.stdout.write(chunk); // write as each word arrives
}
يسرد جميع نماذج AI المتاحة. يعرض ميزات وحدود كل نموذج.
curl -X GET https://www.ailydian.com/api/models \ -H "Authorization: Bearer YOUR_API_KEY"
{
"models": [
{
"id": "LyDian Engine",
"name": "LyDian Engine Omni",
"provider": "lydian-labs",
"capabilities": ["chat", "vision", "code"],
"max_tokens": 128000
},
{
"id": "enterprise-ai-3.5",
"name": "Ultra Intelligence Model",
"provider": "advanced-ai-platform",
"capabilities": ["chat", "code", "analysis"],
"max_tokens": 200000
}
]
}
يقوم بتحليل الصور. كشف الأجسام والتعرف على الوجوه وOCR وتنظيم المحتوى.
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
| image | string | نعم | صورة مشفّرة بـ base64 أو عنوان URL |
| task | string | نعم | detect, ocr, moderate, describe |
const response = await fetch('https://www.ailydian.com/api/vision', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
image: 'https://example.com/image.jpg',
task: 'describe'
})
});
const data = await response.json();
ينشئ صورًا عالية الجودة من وصف نصي. يستخدم نموذج LyDian Image Engine.
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
| prompt | string | نعم | وصف الصورة |
| size | string | لا | 1024x1024, 1792x1024, 1024x1792 |
| quality | string | لا | standard, hd |
const response = await fetch('https://www.ailydian.com/api/generate-image', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
prompt: 'a minimalist mountain landscape at sunset',
size: '1024x1024',
quality: 'hd'
})
});
ترجمة النصوص مع دعم 84 لغة. يستخدم حزمة لغة z.ai.
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
| text | string | نعم | النص المراد ترجمته |
| from | string | لا | اللغة المصدر (كشف تلقائي) |
| to | string | نعم | رمز اللغة الهدف |
const response = await fetch('https://www.ailydian.com/api/translate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: 'hello world',
to: 'tr'
})
});
رموز الخطأ
| الرمز | الحالة | الوصف |
|---|---|---|
| 400 | طلب غير صالح | تنسيق طلب أو معاملات غير صالحة |
| 401 | غير مصرح | مفتاح API غير صالح أو مفقود |
| 403 | ممنوع | ليس لديك إذن للوصول إلى هذا المورد |
| 429 | حد المعدل | طلبات كثيرة جدًا، حاول مرة أخرى لاحقًا |
| 500 | خطأ في الخادم | خطأ في الخادم، تواصل مع فريق الدعم |
تحديد المعدل
طلبات API الخاصة بك محدودة بناءً على نوع خطتك.
| الخطة | الطلبات/الدقيقة | الطلبات/اليوم | حد الرموز |
|---|---|---|---|
| free | 10 | 100 | 10k tokens |
| starter | 60 | 10,000 | 100k tokens |
| pro | 300 | 100,000 | 1M tokens |
| enterprise | غير محدود | غير محدود | غير محدود |