مستندات API سازگار با OpenAI

شروع سریع: ارسال اولین درخواست خود

کلید API خود را به‌سرعت با ثبت‌نام با Google یا ایمیل دریافت کنید. از uncensored شناسه مدل برای تولید متن بدون محدودیت برای نویسندگی خلاق، تحقیقات امنیتی یا محتوای بزرگسالان. API درخواست‌های استاندارد را از طریق POST /v1/chat/completions.

Copycurl https://api.ianoncensure.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 libraries for async python"}]
  }'

هر حساب جدید دسترسی فوری دریافت می‌کند. URL پایه HTTPS://api.ianoncensure.com/v1 است. می‌توانید نقطه پایانی را آزمایش کنید تا از اتصال پیش از یکپارچه‌سازی در گردش کار تولیدی خود اطمینان حاصل کنید.

نقاط پایانی: chat/completions و مدل‌ها

با مدل با استفاده از دو نقطه پایانی ساده تعامل داشته باشید: POST /v1/chat/completions برای تولید و GET /v1/models برای متادیتا. این API یک مدل بزرگ زبانی بدون سانسور خاص را ارائه می‌دهد، نه یک لایه مسیریابی بین چندین ارائه‌دهنده. نیازی به مدیریت انتخاب‌های پیچیده مدل ندارید.

Copyfrom openai import OpenAI

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

درخواست‌ها به صورت متن-ورودی، متن-خروجی پردازش می‌شوند. هیچ endpoint embedding، تولید تصویر یا صوتی وجود ندارد. کتابخانه کلاینت خود را با چسبیدن به این دو مسیر ساده نگه دارید. شناسه مدل همیشه است uncensored.

پارامترها: temperature، top_p و بیشتر

خلاقیت را با temperature و top_p پارامترها. مقدار presence_penalty و frequency_penalty برای کاهش تکرار. از seed برای خروجی‌های قطعی در حین تست استفاده کنید. مدل از stop sequences برای توقف تولید در نشانگرهای خاص.

Copyimport OpenAI from "openai";

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

این پارامترها امکان تنظیم سبک خروجی را فراهم می‌کنند. دماهای بالاتر پاسخ‌های متنوع‌تری تولید می‌کنند، در حالی که مقادیر پایین‌تر انسجام را تضمین می‌نمایند. تمام پارامترها از استانداردهای OpenAI پیروی می‌کنند که مهاجرت را آسان می‌سازد.

پاسخ‌های استریم‌شده از طریق 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)

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

حالت JSON و فراخوانی تابع

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

استفاده tools و tool_choice برای هدایت اقدامات مدل. این قابلیت کارکردهای پیچیده را بدون پس‌پردازش امکان‌پذیر می‌سازد. API منطق اجرای ابزار را به صورت کارآمد مدیریت می‌کند.

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

هر کلید API به ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان محدود است. حداکثر اندازه بدنه درخواست ۸ مگابایت است. خطاها کدهای HTTP استاندارد را برمی‌گردانند: ۴۰۱ برای کلیدهای نامعتبر، ۴۰۲ برای اعتبار ناکافی و ۴۲۹ برای محدودیت نرخ. خطاها و رد شدن درخواست‌ها توکن مصرف نمی‌کنند.

پنجره زمینه (context window) از ۱۰۰,۰۰۰ توکن برای ورودی (prompt) و خروجی (completion) ترکیبی پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. تنظیم max_tokens به طور صریح برای جلوگیری از تجاوز از محدودیت‌ها. اعتبار استفاده نشده هرگز منقضی نمی‌شود.