شروع سریع: ادغام چت apertus ai

پیش‌نیازها و راه‌اندازی

ابتدا یک حساب ایجاد کنید و کلید API خود را دریافت کنید. در صفحه تولید کلید با گوگل یا رمز عبور ایمیل ثبت‌نام کنید. سیستم بلافاصله کلید شما را نمایش می‌دهد تا بتوانید آن را بدون تأخیر کپی کنید. برای ثبت‌نام شماره تلفن لازم نیست. شما $0.50 اعتبار آزمایشی دریافت می‌کنید که برای 7 روز معتبر است، بنابراین می‌توانید اتصال را بدون افزودن وجه آزمایش کنید.

متغیر محیطی یا مشتری SDK خود را به URL پایه صحیح متصل کنید. این URL با کتابخانه‌های استاندارد OpenAI کار می‌کند. فقط URL پایه و کلید خود را تغییر دهید. شناسه مدل "uncensored" است. این نقطه پایانی واحد تمام تکمیل‌های متنی را مدیریت می‌کند. نیازی به مدیریت مسیریابی یا انتخاب مدل‌های مختلف ندارید.

کتابخانه مشتری از پروتکل تکمیل گفتگوی OpenAI پشتیبانی می‌کند. بیشتر SDKهای مدرن به صورت پیش‌فرض کار می‌کنند. بررسی کنید که شبکه شما درخواست‌های HTTPS خروجی را اجازه می‌دهد. سرویس ما از بارهای JSON استاندارد پشتیبانی می‌کند. علاوه بر احراز هویت، به هدرهای خاصی نیاز نیست.

احراز هویت با کلیدهای API

کلید API خود را برای هر درخواست در هدر Authorization ارسال کنید. از طرح Bearer به دنبال رشته کلید خود استفاده کنید. سرویس کلید را با حساب شما اعتبارسنجی می‌کند. کلیدهای نامعتبر خطای 401 Unauthorized را برمی‌گردانند. کلیدهای منقضی یا موجودی ناکافی پاسخ 402 Payment Required را ایجاد می‌کنند. اگر درخواست‌ها شکست خورد، موجودی خود را در داشبورد بررسی کنید.

کلید خود را امن نگه دارید. هر حساب یک کلید فعال دارد. تولید یک کلید جدید، کلید قبلی را نامعتبر می‌کند. کلید خود را در مخازن عمومی قرار ندهید. کلید API تنها شناسه برای استفاده شما است. محدودیت‌های نرخ در سطح کلید اعمال می‌شود، نه در سطح حساب.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

احراز هویت stateless است. سرور توکن را در هر فراخوانی بررسی می‌کند. اگر کلید خود را چرخاندید، تمام کلاینت‌های در حال اجرا را بلافاصله به‌روزرسانی کنید. عدم وجود هدر منجر به رد فوری درخواست می‌شود. پیام خطا به وضوح شکست احراز هویت را بیان می‌کند.

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

یک درخواست POST به نقطه پایانی تکمیل چت ارسال کنید. شناسه مدل "uncensored" و تاریخچه پیام‌های خود را شامل کنید. API یک پاسخ متنی برمی‌گرداند. می‌توانید خروجی را استریم کنید یا منتظر تکمیل کامل بمانید. هر درخواست توکن‌های ورودی و خروجی را مصرف می‌کند. خطاها اعتبار را کسر نمی‌کنند. رد شدن‌ها رایگان هستند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

پاسخ شامل آمار مصرف است. مصرف توکن را ردیابی کنید تا اعتبار پیش‌پرداخت خود را مدیریت کنید. مدل بدون رد محتوای قانونی بزرگسالان پاسخ می‌دهد. می‌توانید پرامپت‌های سیستمی ارسال کنید تا رفتار را تعریف کنید. پیام‌های کاربر مکالمه را هدایت می‌کنند. پنجره زمینه از مجموعاً ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند.

با یک تبادل دو پیامی ساده شروع کنید. این اتصال و کیفیت پاسخ را تأیید می‌کند. temperature و top_p را برای خروجی‌های خلاقانه یا دقیق تنظیم کنید. API از پارامترهای استاندارد پشتیبانی می‌کند. دنباله‌های توقف به درستی کار می‌کنند. مقادیر Seed نتایج قابل تکرار را تضمین می‌کنند.

پاسخ‌های استریم از طریق SSE

با تنظیم پارامتر stream روی true، قابلیت streaming را فعال کنید. API به جای یک شیء JSON واحد، رویدادهای ارسالی سرور (SSE) برمی‌گرداند. هر قطعه شامل بخشی از متن تولید شده است. قطعات را تا پایان جریان بخوانید. قطعه نهایی شامل مصرف کل توکن است.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

استریمینگ تأخیر ادراک‌شده را کاهش می‌دهد. کاربران متن را به صورت بلادرنگ مشاهده می‌کنند. این قابلیت برای رابط‌های چت ایده‌آل است. با توکن‌های جزئی با دقت برخورد کنید. قطعات را برای تشکیل پاسخ کامل به هم متصل کنید. سرور اتصال را زمانی که تولید به پایان می‌رسد، قطع می‌کند.

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

مدیریت پارامترها و حالت‌ها

از پارامترهای استاندارد برای کنترل تولید استفاده کنید. temperature را برای تصادفی بودن تنظیم کنید. top_p را برای نمونه‌گیری هسته تنظیم کنید. دنباله‌های توقف را تعریف کنید تا تولید زودتر متوقف شود. یک seed برای خروجی‌های قطعی ارسال کنید. حالت JSON را با تنظیم response_format روی json_object فعال کنید. مدل هنگام درخواست، JSON معتبر برمی‌گرداند.

فراخوانی تابع پشتیبانی می‌شود. ابزارها را در درخواست تعریف کنید. مدل در صورت لزوم فراخوانی‌های ابزار را بازگردانی می‌کند. آرگومان‌های ابزار را در کد خود تجزیه کنید. نتایج را برای ادامه مکالمه ارسال کنید. این جریان‌های کاری پیچیده عامل‌ها را امکان‌پذیر می‌سازد.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusaichat.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

توکن‌های حداکثر طول خروجی را محدود می‌کنند. پیش‌فرض ۲,۰۴۸ توکن است. در صورت نیاز مقدار بالاتری تنظیم کنید. محدودیت سخت در هر درخواست ۱۶,۰۰۰ توکن است. پنجره زمینه ۱۰۰,۰۰۰ توکن است. طول تاریخچه خود را متناسب با آن برنامه‌ریزی کنید. جریمه‌های فراوانی و حضور به کاهش تکرار کمک می‌کنند.

درک محدودیت‌ها و خطاها

محدودیت نرخ‌ها از پایداری سرویس محافظت می‌کند. می‌توانید 300 درخواست در دقیقه ارسال کنید. همزمانی به هشت درخواست همزمان به ازای هر کلید محدود است. بدنه درخواست نباید از 8 MB تجاوز کند. تجاوز از محدودیت‌ها خطای 429 Too Many Errors را برمی‌گرداند. قبل از تلاش مجدد صبر کنید.

کدهای خطا را برای عیب‌یابی بررسی کنید. ۴۰۱ به معنای کلید نامعتبر یا فاقد کلید است. ۴۰۲ نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. برای ادامه سرویس، از طریق ارز دیجیتال شارژ کنید. ۴۲۹ نشان‌دهنده محدودیت نرخ است. ۴۰۰ نشان‌دهنده سینتکس درخواست نامعتبر است. برای جزئیات، پیام خطا را مرور کنید.

مدیریت پنجره زمینه حیاتی است. توکن‌های prompt و completion را جمع بزنید. به‌طور قابل‌توجهی زیر ۱۰۰,۰۰۰ توکن بمانید. در صورت نیاز پیام‌های قدیمی را کوتاه کنید. API به‌طور خودکار کوتاه نمی‌کند. شما طول تاریخچه را کنترل می‌کنید. استفاده کارآمد از زمینه هزینه‌ها را کاهش می‌دهد.