پرش به مطلب اصلی

کلیدهای API

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

  • آدرس پایه اتصال (Base URL):
    https://my.parspack.com/api/aistudio/api/v1

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

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

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

نکته امنیتی

توکن تولیدشده تنها یک بار پس از ساخت نمایش داده می‌شود. آن را کپی کرده و در یک محیط امن ذخیره کنید.

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

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

from openai import OpenAI

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

if __name__ == '__main__':
    models = client.models.list()

    for m in models:
        print(m.id)

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

نمونه کد زیر برای دریافت تمامی مدل های ارائه شده است:

from openai import OpenAI

client = OpenAI(
    base_url="https://my.parspack.com/api/aistudio/api/v1",
    api_key="<API_KEY>"
)

models = client.models.list()

for model in models.data:
    print(model)

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

from openai import OpenAI

client = OpenAI(
    base_url="https://my.parspack.com/api/aistudio/api/v1",
    api_key="<API_KEY>"
)

stream = client.responses.create(
    model="openrouter/owl-alpha",
    input="What's your name?",
    max_output_tokens=64,
    stream=True,
)

for event in stream:
    print(event)

و همچنین به صورت غیر استریم:

from openai import OpenAI

client = OpenAI(
    base_url="https://my.parspack.com/api/aistudio/api/v1",
    api_key="<API_KEY>"
)

response = client.chat.completions.create(
    model="openrouter/owl-alpha",
    messages=[
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "What's your name?"
        }
    ],
    max_tokens=64,
)

for event in stream:
    print(event)
توجه

توصیه می‌شود کلیدهای API خود را در مکان امن نگهداری کرده و در صورت لو رفتن بلافاصله آن‌ها را باطل کنید.

برای مشاهده کامل نحوه استفاده از هر مدل میتوانید با رفتن به بخش جزئیات مدل نمونه کدها را مشاهده کنید.