مستندات API

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

این API از احراز هویت توکن Bearer استاندارد استفاده می‌کند. شما کلید خود را بلافاصله پس از ثبت‌نام با Google یا آدرس ایمیل دریافت می‌کنید. مقدار Authorization هدر به Bearer YOUR_API_KEY برای تمام درخواست‌ها. URL پایه https://api.llmstatus.cc/v1. این اندپوینت با هر SDK یا کلاینت سازگار با OpenAI کار می‌کند. تنها نیاز دارید URL پایه را تغییر دهید و کلید خود را ارائه دهید. برای ثبت‌نام نیاز به شماره تلفن نیست. هویت شما حداقلی باقی می‌ماند در حالی که به دسترسی کامل دست می‌یابید.

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

یک درخواست POST به /v1/chat/completions برای دریافت پاسخ فوری. شناسه مدل uncensored. محتوای بزرگسالان، تحقیقات امنیتی و موضوعات بحث‌برانگیز را بدون رد شدن مدیریت می‌کند. شما به یک اشتراک یا هزینه ماهانه نیاز ندارید. خطاها اعتبار از پیش پرداخت شده شما را مصرف نمی‌کنند. پرامپت خود را ارسال کنید و مستقیماً خروجی متنی دریافت کنید.

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

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

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

از رسمی openai کتابخانه پایتون برای تعامل با API. URL پایه و کلید API را در مقداردهی اولیه کلاینت پیکربندی کنید. کلاینت سریال‌سازی و تجزیه خطاها را برای شما مدیریت می‌کند. این رویکرد به طور قابل توجهی کد boilerplate را کاهش می‌دهد. می‌توانید پیام‌ها را به صورت لیستی از دیکشنری‌ها ارسال کنید. مدل uncensored صرف‌نظر از بسته‌بندی مشتری. هر دو حالت استریمینگ و غیر استریمینگ پشتیبانی می‌شوند. این روش برای خدمات بک‌اند یا اسکریپ‌های پردازش داده ایده‌آل است.

Copyfrom openai import OpenAI

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

SDK جزئیات HTTP را مدیریت می‌کند. شما بر ساختار prompt و مدیریت پاسخ تمرکز می‌کنید. کدهای خطا به عنوان استثنا (exception) پرتاب می‌شوند. می‌توانید این‌ها را catch کنید تا محدودیت نرخ یا مشکلات اعتبار را به صورت روان مدیریت کنید. کد تمیز و خوانا باقی می‌ماند. این روش توصیه‌شده برای توسعه‌دهندگان پایتون جهت یکپارچه‌سازی API است.

استفاده از SDK Node.js

نصب openai پکیج npm برای محیط‌های Node.js. متغیر محیطی را تنظیم کنید یا کلید را مستقیماً به سازنده پاس دهید. URL پایه باید به سرویس ما اشاره کند. این به شما اجازه می‌دهد تا توابع serverless یا وب‌اپلیکیشن‌ها را به سرعت بسازید. SDK از هر دو ماژول CommonJS و ES پشتیبانی می‌کند. می‌توانید پاسخ‌ها را استریم کنید یا به صورت یکجا دریافت نمایید. کلید API به صورت امن در هدر ارسال می‌شود. این پیکربندی برای توسعه‌دهندگان جاوااسکریپتی که به تولید متن قابل اعتماد نیاز دارند، عالی است. علاوه بر کلید و URL پایه، نیاز به پیکربندی اضافی نیست.

Copyimport OpenAI from "openai";

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

SDK Node ساختار کلاینت Python را بازآفرینی می‌کند. شما پیام‌ها را ارسال می‌کنید و تکمیل‌ها را دریافت می‌کنید. مدیریت خطا در زنجیره promise ساخته شده است. این اطمینان می‌دهد که برنامه شما مقاوم بماند. از این روش برای رابط‌های چت بلادرنگ یا وظایف پس‌زمینه استفاده کنید. کد مختصر و قابل نگهداری آسان است. می‌توانید آن را با هدرهای سفارشی گسترش دهید اگر نیاز باشد.

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

استریمینگ را با تنظیم stream: true در درخواست شما. سرور رویدادهای ارسالی سرور (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)

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

محدودیت‌ها، خطاها و پنجره زمینه

شما یک پنجره زمینه ۱۰۰,۰۰۰ توکنی برای ترکیب درخواست و تکمیل دارید. حداکثر خروجی ۱۶,۰۰۰ توکن به ازای هر درخواست است. محدودیت ۳۰۰ درخواست در دقیقه به ازای هر کلید است. می‌توانید ۸ درخواست همزمان داشته باشید. بدنه درخواست نمی‌تواند از 8 MB تجاوز کند. خطای 401 به معنای نامعتبر بودن کلید شماست. خطای 402 نشان‌دهنده اتمام اعتبار است. خطای 429 نشان می‌دهد که به محدودیت نرخ رسیده‌اید. اعتبار هرگز منقضی نمی‌شود، بنابراین می‌توانید بعداً شارژ کنید. خطاها اعتبار شما را شارژ نمی‌کنند. از این کدها برای اشکال‌زدایی سریع یکپارچه‌سازی خود استفاده کنید. API دقیق اما قابل پیش‌بینی است. همزمانی خود را بر اساس محدودیت ۸ درخواست برنامه‌ریزی کنید.