تخطٍ إلى المحتوى الرئيسي

مرجع API

وثائق API شاملة لمنصة LyDian Enterprise AI. جميع نقاط النهاية والمعاملات وأمثلة الاستخدام.

عنوان URL الأساسي
https://www.ailydian.com/api
تبدأ جميع طلبات API بعنوان URL الأساسي هذا. استخدم نطاقك الخاص في بيئة الإنتاج.
البدء السريع
تستخدم LyDian API بنية RESTful. جميع الطلبات بتنسيق JSON. يتطلب كل طلب مصادقة باستخدام ترويسة authorization.

المصادقة

تتطلب جميع طلبات API مصادقة برمز Bearer. استخدم رمزك في ترويسة authorization.

curl -X GET https://www.ailydian.com/api/models \
  -H "Authorization: Bearer sk-lydian-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"
  • لا تشارك مفتاح API الخاص بك أبدًا في المستودعات العامة
  • خزّنه في متغيرات البيئة
  • لا تستخدمه في الكود من جانب العميل
  • جدّد مفاتيحك بشكل دوري
post /api/chat

ينشئ محادثة مع نماذج 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"
}
post /api/chat

احصل على الردود مع البث في الوقت الفعلي. يتم عرضها فورًا عند وصول كل رمز.

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
}
get /api/models

يسرد جميع نماذج 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
    }
  ]
}
post /api/vision

يقوم بتحليل الصور. كشف الأجسام والتعرف على الوجوه و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();
post /api/generate-image

ينشئ صورًا عالية الجودة من وصف نصي. يستخدم نموذج 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'
  })
});
post /api/translate

ترجمة النصوص مع دعم 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 غير محدود غير محدود غير محدود