> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# استخدم LiteLLM مع CometAPI
> استخدم هذا الدليل لتهيئة LiteLLM مع CometAPI عبر تعيين base URL ومفتاح API وخيارات model أو provider.
يوفّر LiteLLM واجهة Python API موحّدة لأكثر من 100 من مزوّدي LLM. ويدعم CometAPI بشكل أصيل — استخدم البادئة `cometapi/` لتوجيه الطلبات عبر فهرس النماذج في CometAPI.
## المتطلبات الأساسية
* Python 3.6+
* حساب CometAPI مع مفتاح API نشط — [احصل على مفتاحك من هنا](https://www.cometapi.com/console/token)
```bash theme={null}
pip install litellm
```
قم بتعيين مفتاح API كمتغير بيئة (موصى به) أو مرّره مباشرةً داخل السطر:
```python theme={null}
import os
from litellm import completion
# Recommended: environment variable
os.environ["COMETAPI_KEY"] = ""
# Alternative: pass inline
api_key = ""
```
استخدم متغيرات البيئة لتجنب تضمين بيانات الاعتماد الحساسة بشكل ثابت داخل السكربتات الخاصة بك.
استخدم التنسيق `cometapi/` لتحديد النماذج. يمكنك تمرير المفتاح عبر متغير البيئة أو بشكل صريح:
```python theme={null}
messages = [{"content": "Hello, how are you?", "role": "user"}]
# Method 1: environment variable (recommended)
response = completion(model="cometapi/your-model-id", messages=messages)
# Method 2: explicit API key
response = completion(model="cometapi/your-model-id", messages=messages, api_key=api_key)
print(response.choices[0].message.content)
```
استخدم `acompletion` مع `stream=True` للحصول على استجابات غير حاجزة وفي الوقت الفعلي:
```python theme={null}
from litellm import acompletion
import asyncio, traceback
async def stream_call():
try:
response = await acompletion(
model="cometapi/your-model-id",
messages=[{"content": "Hello, how are you?", "role": "user"}],
stream=True,
)
async for chunk in response:
print(chunk)
except Exception:
print(f"Error: {traceback.format_exc()}")
asyncio.run(stream_call())
```
* **تنسيق النموذج**: تستخدم نماذج CometAPI البادئة `cometapi/`، على سبيل المثال `cometapi/your-model-id`. راجع [صفحة نماذج CometAPI](/ar/overview/models) للاطلاع على النماذج المتاحة.
* **ضبط الاستجابات بدقة**: يدعم LiteLLM كلًا من `temperature` و`max_tokens` و`top_p` — أضفها إلى أي استدعاء `completion()`، مثل `completion(..., temperature=0.7)`.
* **معالجة الأخطاء**: لفّ الاستدعاءات داخل `try/except` لالتقاط أخطاء المفاتيح غير الصالحة أو مشكلات الشبكة.
* **الأمان**: لا تقم أبدًا بإيداع مفاتيح API في نظام التحكم بالإصدارات. استخدم متغيرات البيئة أو مدير الأسرار.
* **حدود المعدل**: راقب الاستخدام في [لوحة تحكم CometAPI](https://www.cometapi.com/console).
* **مزيد من الوثائق**: [وثائق LiteLLM](https://docs.litellm.ai/docs/) — [البدء السريع لـ CometAPI](/ar/overview/quick-start)