مستندات API

URL پایه و احراز هویت

برنامه خود را با اشاره به endpoint اختصاصی ما و ارسال کلید API منحصر به فرد خود متصل کنید. URL پایه برای تمام درخواست‌ها https://api.apertusapp.com/v1. کلید خود را بلافاصله پس از ثبت‌نام از طریق Google یا ایمیل در دریافت کلید API صفحه. این کلید را در Authorization هدر برای هر درخواست.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

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

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

ارسان اولین پرامپت به endpoint تکمیل چت برای دریافت متن خام و بدون فیلتر. از شناسه مدل uncensored برای دسترسی به مدل وزن‌باز خاص ما که برای موضوعات بزرگسالان قانونی و بحث‌برانگیز بهینه‌سازی شده است.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusapp.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)

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

یکپارچه‌سازی Node SDK

از SDK رسمی Node برای مدیریت کارآمد حالت JSON و فراخوانی تابع استفاده کنید. تنظیم response_format به {"type": "json_object"} برای خروجی‌های ساختاریافته یا تعریف ابزارها برای رفتار شبیه به عامل.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusapp.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);

مدل از فراخوان ابزارها با tool_choice گزینه‌ها. همچنین می‌توانید یک seed برای نتایج قطعی. این انعطاف‌پذیری به شما اجازه می‌دهد اپلیکیشن‌های پیچیده را بدون خروج از اکوسیستم سازگار با OpenAI بسازید.

پاسخ‌های استریم

توکن‌ها را به صورت بلادرنگ با استفاده از رویدادهای ارسالی سرور (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 پروتکل SSE را به صورت خودکار مدیریت می‌کند و کد کمی از سمت شما نیاز دارد.

پنجره زمینه و ظرفیت

مدل از یک پنجره زمینه ۱۰۰,۰۰۰ توکنی برای ورودی و خروجی به صورت ترکیبی پشتیبانی می‌کند. می‌توانید تا ۱۶,۰۰۰ توکن را در هر درخواست مشخص کنید، یا به ۲,۰۴۸ توکن بازگردید اگر max_tokens.

این پنجره بزرگ برای تحلیل اسناد گسترده یا تاریخچه‌های مکالمه طولانی امکان‌پذیر است. با این حال، بدنه درخواست‌ها را زیر 8 MB نگه دارید. مدل GPT یا Llama نیست؛ بلکه یک مدل هوش مصنوعی بدون سانسور متمایز است که برای مورد استفاده خاص شما بهینه شده است.

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

خطاهای HTTP استاندارد را به‌خوبی مدیریت کنید تا جریان برنامه قوی حفظ شود. یک 401 خطا نشان‌دهنده کلید API نامعتبر یا فاقد کلید است. یک 402 خطا به این معنی است که اعتبار پیش‌پرداخت شما تمام شده است. یک 429 خطا نشان‌دهنده این است که شما از محدودیت ۳۰۰ درخواست در دقیقه یا ۸ درخواست همزمان تجاوز کرده‌اید.

اعتبار شما منقضی نمی‌شود، بنابراین می‌توانید استفاده را متوقف و بعداً ادامه دهید. خطاهایی مانند شارژ‌های دوتایی از طریق صفحه پشتیبانی رفع می‌شوند. اعتبار پیش‌پرداخت‌شده تنها بابت مصرف واقعی توکن‌ها کسر می‌شود که قیمت‌گذاری شفاف را برای هر بایت تضمین می‌کند.