احراز هویت: تنظیم کلید API شما
کلید API شما هر درخواست را احراز هویت میکند. این کلید بلافاصله پس از ثبتنام با گوگل یا آدرس ایمیل دریافت میشود. آن را امن نگه دارید، زیرا دسترسی به اعتبار پیشپرداخت شما را فراهم میکند. کلید به عنوان تنها شناسه شما برای محدودیت نرخ و صورتحساب عمل میکند. در صورت نیاز میتوانید آن را به صورت دستی از داشبورد تغییر دهید، با این توجه که کلید جدید بلافاصله کلید قبلی را جایگزین میکند.
ساختار URL پایه و نقطه پایانی
آدرس پایه برابر است با HTTPS://api.chatunfiltered.com/v1. این ساختار سازگاری با SDKهای استاندارد OpenAI را تضمین میکند. شما تنها نیاز به تعامل با نقطه پایان تکمیل چت دارید. امبدینگها، تولید تصویر و پردازش صدا در دسترس نیستند. آدرس پایه خود را در تمام پیکربندیهای کلاینت یکسان نگه دارید تا از خطاهای مسیریابی جلوگیری کنید.
curl https://api.chatunfiltered.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check server status"}]
}'
انجام اولین درخواست POST
یک درخواست POST به /v1/chat/completions ارسال کنید تا متن تولید شود. کلید API خود را در هدر Authorization قرار دهید. مدل را روی "uncensored" تنظیم کنید تا به LLM اختصاصی بدون سانسور دسترسی پیدا کنید. بدنه درخواست باید شامل یک آرایه messages با پرامپت شما باشد. پاسخها استفاده از توکن و محتوای تولید شده را برمیگردانند. این رویکرد مستقیم، تأخیر را نسبت به پراکسیهای چندمدلی به حداقل میرساند.
from openai import OpenAI
client = OpenAI(base_url="https://api.chatunfiltered.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)
درک قالبهای پاسخ و Streaming
پاسخها را در قالب JSON استاندارد دریافت کنید یا آنها را از طریق رویدادهای ارسالی سرور استریم کنید. استریم به شما امکان میدهد توکنها را همانطور که تولید میشوند پردازش کنید، که تأخیر ادراکشده را برای خروجیهای طولانی بهبود میبخشد. قطعه نهایی در یک جریان شامل کل استفاده توکن برای صورتحساب دقیق است. همچنین میتوانید حالت JSON را برای خروجیهای داده ساختاریافته اعمال کنید. روشی را انتخاب کنید که بهترین تطابق را با معماری برنامه شما دارد.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatunfiltered.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);
پیکربندی پارامترها: دما، Top-P و ابزارها
دما و top_p را برای کنترل تصادفیسازی پاسخ تنظیم کنید. از tool_choice برای قابلیتهای فراخوانی تابع استفاده کنید. مدل از حالت JSON دقیق از طریق response_format پشتیبانی میکند. همچنین میتوانید توالیهای توقف را تنظیم کنید تا تولید در نقاط خاصی متوقف شود. این پارامترها کنترل دقیقی بر رفتار مدل بدون سانسور بدون لایههای مسیریابی خارجی فراهم میکنند.
stream = 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)
مدیریت خطا و ردیابی مصرف توکن
خطاهای 401 را برای کلیدهای نامعتبر و خطاهای 402 را برای اعتبار ناکافی مدیریت کنید. محدودیتهای نرخ وقتی از 300 درخواست در دقیقه فراتر میروید 429 برمیگردانند. پنجره زمینه شما 100,000 توکن برای پراپت و تکمیل ترکیب شده است. خطاها و رد شدنها اعتبار پیشپرداخت شما را مصرف نمیکنند. مصرف توکن را در قطعه نهایی پخش زنده ردیابی کنید تا هزینهها را به دقت مدیریت کنید.