بدء سريع
لبدء استخدام LyDian API، تحتاج أولاً إلى مفتاح API. يمكنك إنشاء مفتاح API الخاص بك من لوحة التحكم والبدء باستخدامه فوراً.
المصادقة
تتطلّب جميع طلبات API مفتاح API في ترويسة Authorization. أرسل مفتاح API الخاص بك كرمز Bearer.
ترويسة HTTP
Authorization: Bearer YOUR_API_KEY
عنوان URL الأساسي
عنوان URL الأساسي لجميع نقاط نهاية API. استخدم دائماً HTTPS في بيئة الإنتاج.
https://api.ailydian.com/v1
إكمال المحادثة
نقطة النهاية الرئيسية للدردشة مع نماذج LyDian AI. أوضاع البث (Streaming) وغير البث. استخدم البث للاستجابات في الوقت الفعلي.
/chat/completions
اطرح أسئلة على نماذج الذكاء الاصطناعي عبر نقطة نهاية إكمال المحادثة، واكتب التعليمات البرمجية، وأنشئ المحتوى، والمزيد.
معلمات الطلب
| المعلمة | النوع | الوصف |
|---|---|---|
modelمطلوب
|
string | معرّف النموذج (مثل: "lydian-turbo"، "lydian-pro") |
messagesمطلوب
|
array | مصفوفة من رسائل المحادثة (role, content) |
temperatureاختياري
|
number | من 0 إلى 2 (الافتراضي: 0.7) - مستوى الإبداع |
max_tokensاختياري
|
integer | الحد الأقصى لعدد الرموز (الافتراضي: 2000) |
streamاختياري
|
boolean | وضع البث (الافتراضي: false) |
مثال على الطلب
const response =
await
fetch('https://api.ailydian.com/v1/chat/completions', { method:
'POST', headers:
{ 'Authorization':
'Bearer sk-lydian-...',
'Content-Type':
'application/json'
},
body: JSON.stringify({ model:
'lydian-turbo',
messages: [ { role:
'user', content:
'Merhaba! AI ile neler yapabilirim?' } ],
temperature: 0.7,
max_tokens: 2000
}) });
const data =
await response.json(); console.log(data.choices[0].message.content);
import requests url =
"https://api.ailydian.com/v1/chat/completions"
headers = {
"Authorization":
"Bearer sk-lydian-...",
"Content-Type":
"application/json"
} data = {
"model":
"lydian-turbo",
"messages": [ {"role": "user",
"content":
"Merhaba! AI ile neler yapabilirim?"} ],
"temperature":
0.7,
"max_tokens":
2000 } response = requests.post(url, json=data, headers=headers)
print(response.json()["choices"][0]["message"]["content"])
curl https://api.ailydian.com/v1/chat/completions \ -H
"Authorization: Bearer sk-lydian-..." \ -H
"Content-Type: application/json" \ -d
'{ "model": "lydian-turbo", "messages": [ {"role": "user", "content":
"Merhaba! AI ile neler yapabilirim?"} ], "temperature": 0.7, "max_tokens":
2000 }'
مثال على الاستجابة
{ "id":
"chatcmpl-abc123",
"object":
"chat.completion",
"created":
1677858242,
"model":
"lydian-turbo",
"choices": [ {
"index": 0,
"message": { "role":
"assistant",
"content":
"Hello! You can do many things with AI..."
},
"finish_reason":
"stop"
} ],
"usage": {
"prompt_tokens":
12,
"completion_tokens":
145,
"total_tokens":
157 } }
توليد الصور
أنشئ صوراً عالية الجودة من أوصاف نصية باستخدام LyDian Image Engine ونماذج توليد الصور الأخرى.
/images/generate
أنشئ صوراً بجودة احترافية من أوصاف نصية عبر نقطة نهاية توليد الصور. تتوفّر خيارات مختلفة للحجم والجودة.
معلمات الطلب
| المعلمة | النوع | الوصف |
|---|---|---|
promptمطلوب
|
string | وصف الصورة (بحد أقصى 1000 حرف) |
sizeاختياري
|
string | "1024x1024"، "1792x1024"، "1024x1792" (الافتراضي: "1024x1024") |
nاختياري
|
integer | عدد الصور المراد توليدها: 1-4 (الافتراضي: 1) |
qualityاختياري
|
string | "standard" أو "hd" (الافتراضي: "standard") |
مثال على الطلب
curl https://api.ailydian.com/v1/images/generate \ -H
"Authorization: Bearer sk-lydian-..." \ -H
"Content-Type: application/json" \ -d
'{ "prompt": "Futuristic city with flying cars at sunset", "size": "1024x1024",
"n": 1, "quality": "hd" }'
النماذج المتاحة
جميع نماذج الذكاء الاصطناعي المتاحة على منصة LyDian. يأتي كل نموذج بقدرات وأسعار مختلفة.
/models
يسرد جميع نماذج الذكاء الاصطناعي المتاحة. قدرات كل نموذج وحجم نافذة السياق ومعلومات التسعير.
النماذج الشائعة
رموز الأخطاء
تستخدم API رموز حالة HTTP القياسية. تحتوي جميع استجابات الأخطاء على معلومات مفصّلة عن الخطأ بتنسيق JSON.
رموز الحالة
| Code | Status | Description |
|---|---|---|
200 |
OK | تم الطلب بنجاح |
400 |
Bad Request | الطلب غير صالح أو يحتوي على معلمات مفقودة |
401 |
Unauthorized | مفتاح API غير صالح أو مفقود |
403 |
Forbidden | مفتاح API صالح لكن غير مصرّح به |
404 |
Not Found | المورد المطلوب غير موجود |
429 |
Rate Limit Exceeded | تم إرسال طلبات كثيرة جداً |
500 |
Internal Server Error | خطأ في الخادم |
503 |
Service Unavailable | الخدمة غير متاحة مؤقتاً |
تنسيق استجابة الخطأ
{ "error": {
"message":
"Invalid API key provided",
"type":
"invalid_request_error",
"code":
"invalid_api_key" } }
حدود المعدّل
تُطبَّق حدود معدّل API على أساس الدقيقة والساعة. عند تجاوز الحدود، يتم إرجاع رمز الحالة 429. تحتوي كل استجابة على ترويسات تتضمّن معلومات حدود المعدّل الخاصة بك.
الحدود الافتراضية
| الخطة | طلبات/دقيقة | طلبات/ساعة | رموز/دقيقة |
|---|---|---|---|
| Free | 3 | 100 | 50,000 |
| Pro | 60 | 3,000 | 500,000 |
| Enterprise | Custom | Custom | Custom |
X-RateLimit-Limit, X-RateLimit-Remaining,
X-RateLimit-Reset