مستندات

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

ابتدا با ارسال درخواست‌ها به نقطه پایانی اختصاصی و قرار دادن کلید API خود در هدر شروع کنید. سرویس ما از یک ساختار سازگار با OpenAI استفاده می‌کند، بنابراین تنها نیاز دارید URL پایه و کلید خود را به‌روزرسانی کنید. URL پایه HTTPS://api.bestabliteratedmodels.com/v1 است. می‌توانید کلید خود را بلافاصله پس از ثبت‌نام با گوگل یا ایمیل ایجاد کنید. برای حساب کاربری به شماره تلفن نیاز نیست.

Copycurl https://api.bestabliteratedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 endpoints with zero refusals for uncensored chat"}]
  }'

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

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

یک درخواست تکمیل چت پایه برای آزمایش endpoint ارسال کنید. از شناسه مدل 'uncensored' برای دریافت خروجی‌ها بدون ردّهای محتوایی استفاده کنید. API پارامترهای استاندارد مانند temperature و top_p را می‌پذیرد. می‌توانید یک پرامپت ساده ارسال کنید تا بررسی کنید که اتصال به درستی کار می‌کند.

Copyfrom openai import OpenAI

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

اشیای پاسخ را برای متن تولید شده بررسی کنید. مدل پنجره‌های زمینه را تا 100,000 توکن مدیریت می‌کند. این شامل ورودی و خروجی شما به صورت ترکیبی است. خطاهایی مانند کلیدهای نامعتبر کدهای وضعیت 401 را برمی‌گردانند.

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

API را در برنامه‌های Node.js خود با استفاده از SDK رسمی ادغام کنید. کلاینت را با URL پایه و کلید API خود پیکربندی کنید. ساختار کد با پیاده‌سازی‌های استاندارد OpenAI مطابقت دارد. این مهاجرت از سایر ارائه‌دهندگان را مستقیم می‌کند.

Copyimport OpenAI from "openai";

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

داده‌های پاسخ را برای استخراج تکمیل مدیریت کنید. API از فراخوانی تابع و حالت JSON پشتیبانی می‌کند. می‌توانید خروجی‌های JSON دقیق را با تنظیم پارامتر response_format اعمال کنید. این برای ساخت پایپ‌لاین‌های داده ساختاریافته مفید است.

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

پخش زنده را فعال کنید تا توکن‌ها به محض تولید دریافت شوند. این کار تأخیر ادراک‌شده را برای کاربران کاهش می‌دهد. API از رویدادهای ارسالی سرور (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 خطای 402 برمی‌گرداند. می‌توانید موجودی خود را با ارز دیجیتال شارژ کنید. ما USDT روی TRC20 یا USDC روی Base را می‌پذیریم. حداقل شارژ 20 دلار است. پاداش‌ها برای مبالغ بزرگتر اعمال می‌شود. خطاهایی مانند کلید نامعتبر 401 برمی‌گردانند.

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

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

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