استخدام OpenAI SDK في Python
يشرح هذا الدليل كيفية تثبيت واستخدام OpenAI SDK في Python للاتصال بـ API كاكوتي.
🔧 تثبيت SDK
يمكنك تثبيت OpenAI SDK باستخدام pip أو uv.
التثبيت باستخدام pip
pip install openaiالتثبيت باستخدام uv
uv pip install openai💡 حول uv
uvهو أداة جديدة وسريعة لإدارة حزم Python، تم بناؤها بواسطة Astral. من الميزات المهمة:
- السرعة العالية: تثبيت الحزم أسرع بـ 10-100 مرة من pip
- إدارة البيئة الافتراضية: إنشاء وإدارة البيئات الافتراضية تلقائيًا
- التوافق الكامل: بديل مباشر لـ pip و pip-tools
- التثبيت السريع: مكتوب بـ Rust للأداء الأمثل
- إدارة التبعيات: حل التبعيات بسرعة ودقة عالية
لتثبيت
uv، يمكنك استخدام الأمر التالي:curl -LsSf https://astral.sh/uv/install.sh | sh
🚀 استخدام SDK
لاستخدام OpenAI SDK مع API كاكوتي، تحتاج إلى تكوين Base URL ومفتاح API.
مثال كامل
from openai import OpenAI
# إنشاء عميل مع Base URL ومفتاح API من كاكوتي
client = OpenAI(
base_url="https://llm-api.kakoti.com/v1",
api_key="YOUR_API_KEY"
)
# إرسال الطلب
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "مرحبا! كيف يمكنني مساعدتك؟"}
]
)
# عرض الاستجابة
print(response.choices[0].message.content)📝 الشرح
- base_url: عنوان Base URL من كاكوتي (
https://llm-api.kakoti.com/v1) - api_key: مفتاح API الذي تلقيته من لوحة تحكم كاكوتي
- model: اسم النموذج المستخدم (مثل
gpt-4o-mini،gpt-4o) - messages: مصفوفة من الرسائل للمحادثة
🔐 استخدام متغيرات البيئة
لأمان أفضل، يمكنك تخزين مفتاح API في متغيرات البيئة:
import os
from openai import OpenAI
# قراءة مفتاح API من متغير البيئة
api_key = os.getenv("KAKOTI_API_KEY")
client = OpenAI(
base_url="https://llm-api.kakoti.com/v1",
api_key=api_key
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "مرحبا"}
]
)
print(response.choices[0].message.content)ثم قم بتعيين متغير البيئة:
export KAKOTI_API_KEY="your-api-key-here"💡 مثال متقدم
from openai import OpenAI
client = OpenAI(
base_url="https://llm-api.kakoti.com/v1",
api_key="YOUR_API_KEY"
)
# محادثة مع عدة رسائل - مساعد إدارة الثروة
messages = [
{
"role": "system",
"content": "أنت مستشار مالي محترف ومتخصص في إدارة الثروة. تتخصص في تحليل الأسواق المالية، وتخطيط الاستثمار، وإدارة المخاطر، وتحسين محفظة الاستثمار. تقدم دائمًا توصياتك بناءً على مبادئ مالية محافظة ومتوافقة مع أهداف العملاء طويلة الأجل."
},
{
"role": "user",
"content": "أنا أبلغ من العمر 35 عامًا وأريد التخطيط للتقاعد خلال 30 عامًا. لدي حاليًا 50,000 دولار في المدخرات ويمكنني توفير 1,000 دولار شهريًا. يرجى اقتراح استراتيجية استثمار متنوعة ومتوازنة مع مراعاة المخاطر المعتدلة."
}
]
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=messages,
temperature=0.7,
max_tokens=500
)
print(response.choices[0].message.content)