استفاده از 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 ساخته شده است. از ویژگیهای مهم آن میتوان به موارد زیر اشاره کرد:
- سرعت بالا: نصب پکیجها تا ۱۰-۱۰۰ برابر سریعتر از pip
- مدیریت محیط مجازی: ایجاد و مدیریت محیطهای مجازی به صورت خودکار
- سازگاری کامل: جایگزین مستقیم pip و pip-tools
- نصب سریع: نوشته شده با Rust برای عملکرد بهینه
- مدیریت وابستگیها: حل وابستگیها با سرعت و دقت بالا
برای نصب
uvمیتوانید از دستور زیر استفاده کنید:curl -LsSf https://astral.sh/uv/install.sh | sh
🚀 استفاده از SDK
برای استفاده از OpenAI SDK با API کاکوتی، باید Base URL و API Key را تنظیم کنید.
مثال کامل
from openai import OpenAI
# ایجاد کلاینت با Base URL و API Key کاکوتی
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 Key را در متغیرهای محیطی ذخیره کنید:
import os
from openai import OpenAI
# خواندن API Key از متغیر محیطی
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": "من ۳۵ ساله هستم و میخواهم برای بازنشستگی در ۳۰ سال آینده برنامهریزی کنم. در حال حاضر ۵۰۰ میلیون تومان پسانداز دارم و ماهانه ۱۰ میلیون تومان میتوانم پسانداز کنم. لطفاً یک استراتژی سرمایهگذاری متنوع و متعادل با در نظر گیری ریسک متوسط پیشنهاد دهید."
}
]
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=messages,
temperature=0.7,
max_tokens=500
)
print(response.choices[0].message.content)