مستندات API و شروع سریع

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

از کلید API خود با آدرس پایه https://api.chatuncensored.cc/v1. کلید را در Authorization هدر به عنوان یک توکن Bearer. این پیکربندی با هر SDK یا کلاینت سازگار با OpenAI کار می‌کند.

کلید خود را در داشبورد با گوگل یا ایمیل ایجاد کنید. آن را امن نگه دارید. شما $0.50 اعتباری به مدت 7 روز دریافت می‌کنید. از این اعتبار برای تست اتصال قبل از شارژ با ارز دیجیتال استفاده کنید.

POST /v1/chat/completions

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

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

پارامترهایی مانند دما یا top_p را برای نتایج متنوع تنظیم کنید. مدل تا ۱۰۰,۰۰۰ توکن ترکیبی را مدیریت می‌کند.

خطاهایی مانند رد درخواست‌ها یا مشکلات شبکه اعتبار شما را مصرف نمی‌کنند. شما فقط برای تولید موفق توکن‌ها پرداخت می‌کنید.

استفاده از SDK پایتون

کتابخانه رسمی OpenAI Python را نصب کنید. URL پایه را طوری پیکربندی کنید که به API ما اشاره کند. کلید API را در محیط یا کلاینت تنظیم کنید.

یک نمونه کلاینت ایجاد کنید. با استفاده از مدل و پیام‌ها، chat.completions.create را فراخوانی کنید. پاسخ دستیار را از شیء پاسخ دریافت کنید.

استثنائات مربوط به محدودیت نرخ یا کلیدهای نامعتبر را مدیریت کنید. SDK تجزیه JSON و قالب‌بندی درخواست را ساده می‌کند.

ابتدا با اعتبار آزمایشی تست کنید. ساختار پاسخ را قبل از مقیاس‌دهی استفاده با انتظارات مطابقت دهید.

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

پکیج OpenAI Node را ایمپورت کنید. کلاینت را با URL پایه و کلید خود مقداردهی اولیه کنید. مدل را به عنوان uncensored.

متد completions را با آرایه پیام‌های خود فراخوانی کنید. منتظر پاسخ بمانید تا متن تولید شده را دریافت کنید. این کار به‌طور روان با توابع async کار می‌کند.

استفاده از حالت JSON با تنظیم response_format به {"type": "json_object"}, اطمینان حاصل کنید که خروجی شما JSON معتبر برای استفاده برنامه‌ای است.

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

استریم، ابزارها و حالت JSON

استریمینگ را با تنظیم stream به true. قطعات را از طریق رویدادهای Server-Sent دریافت کنید. هر توکن را هنگام دریافت برای تأخیر پایین پردازش کنید.

از فراخوانی تابع با ابزارها و tool_choice پشتیبانی می‌کند. اسکیمایی‌ها را برای APIهای خارجی تعریف کنید. مدل آرگومان‌های ساختاریافته را برای اجرا برمی‌گرداند.

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

استریم را با ابزارها برای تجربیات تعاملی ترکیب کنید. رابط کاربری را توکن به توکن به‌روزرسانی کنید. کاربران را با تولید بلادرنگ درگیر نگه دارید.

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

انتظار ۳۰۰ درخواست در دقیقه به ازای هر کلید را داشته باشید. تعداد درخواست‌های همزمان را به ۸ محدود کنید. اندازه بدنه درخواست باید کمتر از ۸ مگابایت باشد.

خطاهای 401 را با تأیید کلید API خود مدیریت کنید. به دنبال غلط املایی یا کلیدهای منقضی شده بگردید. در صورت لزوم آن‌ها را مجدداً ایجاد کنید.

فوری 402 دریافت کنید وقتی اعتبار تمام شود. با USDT یا USDC شارژ کنید. اعتبارها منقضی نمی‌شوند. +15% بونوس روی واریزی‌های $200 اضافه کنید.

خطای 429 در محدودیت‌های نرخ. از بازگشت نمایی استفاده کنید. پس از تأخیر مشخص شده مجدداً تلاش کنید. مصرف را برای جلوگیری از اختلال نظارت کنید.

cURL

Copycurl https://api.chatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set user role to beta tester for the new chat interface"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)