شروع سریع: ادغام API LLM بدون سانسور

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

ابتدا کلاینت خود را به URL پایه ما اشاره دهید و کلید خود را در هدر ارسال کنید. نقطه پایانی در https://api.kiohnegrenzen.com/v1 و هدرهای استاندارد OpenAI را می‌پذیرد. شما به یک کلید API نیاز دارید که آن را در دریافت کلید API صفحه. برای شروع از احراز هویت با گوگل یا ایمیل استفاده کنید. نیازی به شماره تلفن نیست. کلید دسترسی به مدل بدون سانسور را فراهم می‌کند.

هدر الزامی: Authorization: Bearer YOUR_API_KEY

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

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

یک درخواست POST به /v1/chat/completions با شناسه مدل و پرامپت. از uncensored به عنوان شناسه مدل. این مدل برای پاسخ دادن بدون ردیوبی برای محتوای بزرگسالان قانونی تنظیم شده است. ورودی متنی را مدیریت کرده و خروجی متنی برمی‌گرداند. می‌توانید پارامترهایی مانند temperature یا top_p برای کنترل خ creativite. سیستم فراخوانی تابع و حالت JSON برای داده‌های ساختاریافته را پشتیبانی می‌کند.

مدل: uncensored

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

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

از رسمی openai پکیج پایتون برای تعامل با API. URL پایه را به نقطه پایانی ما تنظیم کنید و کلید خود را ارائه دهید. این به شما اجازه می‌دهد تا از ساختارهای کد موجود بهره‌مند شوید. می‌توانید پیام‌ها را به صورت لیستی از دیکشنری‌ها ارسال کنید. شیء پاسخ شامل متن تولید شده و آمار مصرف توکن است. استریم از طریق ژنراتورهای async پشتیبانی می‌شود.

پارامترهای کلیدی: temperature, top_p, stop, seed.

پکیج را با pip نصب کنید. کلاس client را import کنید. آن را با base URL خود مقداردهی اولیه کنید. یک درخواست تکمیل گفتگو ارسال کنید. SDK سریال‌سازی JSON و انتقال HTTP را برای شما مدیریت می‌کند.

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

SDK OpenAI Node.js را با URL پایه ما مقداردهی اولیه کنید. این سازگاری با پروژه‌های JavaScript یا TypeScript شما را تضمین می‌کند. کلید API و URL پایه را در سازنده وارد کنید. یک درخواست تکمیل چت را با شناسه مدل uncensored. SDK یک جریان پاسخ یا یک شیء تکی برمی‌گرداند. می‌توانید پارامترهایی مانند presence_penalty و frequency_penalty.

پیکربندی: تنظیم baseURL و apiKey.

SDK هم درخواست‌های سینکرون و هم آسنکرون را پشتیبانی می‌کند. از async/await برای عملیات غیرمسدودکننده استفاده کنید. خطاها را به صورت روان مدیریت کنید. خطاهای شبکه و API را catch کنید. استفاده از توکن را برای ردیابی هزینه لاگ کنید.

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

استریمینگ را با تنظیم stream: true در درخواست شما. API رویدادهای ارسالی سرور (SSE) را برمی‌گرداند. هر قطعه شامل متن جزئی است. قطعه نهایی شامل کل مصرف توکن است. این برای برنامه‌های بلادرنگ ایده‌آل است. می‌توانید توکن‌ها را همان‌طور که دریافت می‌شوند نمایش دهید. مدل از تا 16,000 توکن در هر درخواست پشتیبانی می‌کند. تنظیم max_tokens برای کنترل طول خروجی. پیش‌فرض ۲,۰۴۸ توکن است اگر مشخص نشده باشد.

استریم: از طریق کتابخانه کلاینت یا HTTP خام فعال کنید.

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

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

پنجره زمینه (context window) از ۱۰۰,۰۰۰ توکن برای ورودی (prompt) و خروجی (completion) ترکیبی پشتیبانی می‌کند. این امکان اسناد بزرگ را فراهم می‌کند. مصرف توکن را پایش کنید تا از تجاوز از محدودیت‌ها جلوگیری شود. خطاها شامل ۴۰۱ برای کلیدهای نامعتبر، ۴۰۲ برای اعتبار ناکافی و ۴۲۹ برای محدودیت نرخ است. رد شدن‌ها رایگان هستند. اعتبار پیش‌پرداخت است و هرگز منقضی نمی‌شود. با USDT یا USDC شارژ کنید. برای شارژ‌های بزرگ‌تر پاداش‌ها اعمال می‌شود. برای خروجی ساختاریافته از حالت JSON استفاده کنید. فراخوانی تابع پشتیبانی می‌شود. حریم خصوصی حفظ می‌شود؛ ورودی‌ها برای آموزش استفاده نمی‌شوند.

cURL

Copycurl https://api.kiohnegrenzen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 300 word technical blog post about vector databases."}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)