کلیدهای API

برای اتصال برنامه‌ها و سرویس‌های خارجی به AI Studio، تمام درخواست‌های برنامه‌نویسی به پلتفرم AI Studio باید از طریق آدرس پایه یکتای زیر و به همراه یک کلید API معتبر ارسال شوند.

آدرس پایه اتصال (Base URL):

https://ai.parspack.com/v1

نحوه ایجاد و مدیریت کلیدها

۱. در پنل کاربری، به بخش کلیدهای API مراجعه کرده و روی ایجاد کلید API جدید کلیک کنید.

۲. برای مدیریت بهتر منابع، می‌توانید پیکربندی‌های امنیتی زیر را روی کلید خود اعمال کنید:

• تنظیم محدودیت بودجه: تعیین سقف هزینه دوره‌ای برای جلوگیری از هزینه‌های پیش‌بینی‌نشده.
• تنظیم تاریخ انقضا: تعیین زمان اعتبار برای کلیدهای موقت.
• محدودسازی مدل‌ها: صدور دسترسی منحصرا برای یک یا چند مدل خاص.
• محدودسازی IP: محدود کردن پردازش درخواست‌ها تنها به IP یا رنج IPهای سرورهای شما.

با کلیک روی دکمه «ایجاد کلید» یک کلید API ایجاد می‌شود.

دریافت داینامیک لیست مدل‌های فعال

شما می‌توانید همواره آخرین لیست مدل‌های فعال در پلتفرم را به صورت داینامیک از طریق قطعه کد زیر دریافت کنید:

from openai import OpenAI

client = OpenAI(
base_url="https://ai.parspack.com/v1/",
api_key="YOUR_API_KEY_HERE",
)

if __name__ == '__main__':
models = client.models.list()
for m in models:
print(m.id)

ارسال درخواست و تولید پاسخ

نمونه کد زیر نحوه فراخوانی استاندارد یک مدل و دریافت پاسخ به صورت Stream را نشان می‌دهد:

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.parspack.com/v1/",
    api_key="YOUR_API_KEY_HERE"
)

stream = client.chat.completions.create(
    model="Grok 4",
    messages=[{"role": "user", "content": "What's your name?"}],
    max_tokens=64,
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")