مستندات API

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

API از استانداردهای رایج OpenAI پیروی می‌کند. استفاده کنید HTTPS://api.chatkiohnezensur.com/v1 به‌عنوان آدرس پایه (base URL). کلید خود را پس از ثبت‌نام با گوگل یا ایمیل از داشبورد دریافت کنید. این کلید را امن نگه دارید. آن را در Authorization هدر به عنوان یک توکن bearer.

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

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

Copycurl https://api.chatkiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the three main points of the provided text"}]
  }'

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

متن را به مدل با استفاده از SDK رسمی ارسال کنید. بسته را نصب کنید و کلید خود را پیکربندی کنید. شناسه مدل uncensored. درخواست‌ها پاسخ‌های متنی را مستقیماً برمی‌گردانند. این روش برای نقش‌آفرینی یا نویسندگی خلاقانه بدون محدودیت مناسب است.

دمای را برای خلاقیت تنظیم کنید. از top_p برای نمونه‌گیری هسته. Adjust max_tokens برای کنترل طول خروجی. حداکثر پیش‌فرض ۲,۰۴۸ توکن است مگر اینکه خلاف آن را مشخص کنید. خطاها و رد شدن‌ها اعتبار مصرف نمی‌کنند.

فرمت‌دهی پاسخ به صورت JSON استاندارد است. استثناها را به صورت منطقی مدیریت کنید. API از استریم برای خروجی بلادرنگ پشتیبانی می‌کند. از پارامتر stream برای تجربه کاربری بهتر در برنامه‌ها استفاده کنید.

Copyfrom openai import OpenAI

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

API را به راحتی در برنامه‌های Node.js ادغام کنید. URL پایه را به درستی پیکربندی کنید. کلید API را در هدرها ارسال کنید. SDK سریال‌سازی را به صورت خودکار مدیریت می‌کند. این به طور قابل توجهی کد boilerplate را کاهش می‌دهد.

پاسخ‌ها را برای به‌روزرسانی رابط کاربری در زمان واقعی جریان دهید. قطعات را همان‌طور که دریافت می‌شوند پردازش کنید. این تجربه‌ای روان‌تر برای کاربران در انتظار خروجی‌های بلند فراهم می‌کند. پنجره زمینه تا 100,000 توکن در کل پشتیبانی می‌کند.

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

Copyimport OpenAI from "openai";

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

استریمینگ و SSE

استریمینگ را با تنظیم stream: true در درخواست شما. 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 اجازه ۳۰۰ درخواست در دقیقه را می‌دهد. همزمانی به ۸ درخواست همزمان محدود است. بدنه‌های درخواست نمی‌توانند بیش از ۸ مگابایت باشند. این محدودیت‌ها از سوءاستفاده در زمان‌های اوج استفاده جلوگیری می‌کنند.

حد نرخ‌ها هر دقیقه بازنشانی می‌شود. تجاوز از آن‌ها خطای 429 برمی‌گرداند. قبل از تلاش مجدد صبر کنید. پلن‌های ممتاز ممکن است در آینده محدودیت‌های بالاتری ارائه دهند.

پنجره زمینه از ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. این شامل هر دو prompt و completion است. مصرف را برای ماندن در حدود مجاز نظارت کنید. ورودی‌های بزرگ اعتبار بیشتری مصرف می‌کنند.

شمارش توکن و هزینه‌ها

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

شارژ با ارز دیجیتال. USDT روی شبکه TRC20 یا USDC روی شبکه Base. حداقل واریز $20 است. اعتبار بونوس برای مبالغ بیشتر اعمال می‌شود. +5٪ از $50، +10٪ از $100، +15٪ از $200.

حساب‌های جدید ۰.۵۰ دلار اعتبار آزمایشی دارند. ۷ روز معتبر است. مصرف را در داشبورد بررسی کنید. برای اعتبار استرداد صادر نمی‌شود.