استفاده از OpenAI SDK در Python

استفاده از 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)