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

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

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

از URL پایه HTTPS://api.grokaiuncensored.com/v1 استفاده کنید و کلید API خود را در هدر Authorization قرار دهید. شما یک کلید فعال به ازای هر حساب دریافت می‌کنید که بلافاصله پس از ثبت‌نام با گوگل یا ایمیل دریافت می‌شود. شما فقط متغیرهای base_url و API key را در پیکربندی خود به روز می‌کنید.

نقطه پایانی تکمیل چت

پرامپت‌های متنی ارسال کنید و تکمیل‌ها را از طریق endpoint استاندارد chat-completions دریافت کنید. این یک API فقط متنی است و قابلیت‌های embedding، تولید تصویر یا پردازش صوتی ندارد.

درخواست POST را به /v1/chat/completions ارسال کنید و آرایه پیام‌های خود را وارد کنید. شناسه مدل "uncensored" است. این مدل برای پاسخ‌دهی بدون رد محتوا برای استفاده بزرگسالان قانونی تنظیم شده است، هرچند همیشه محتوای جنسی مرتبط با کودکان را مسدود می‌کند.

شما می‌توانید تا ۸ مگابایت در بدنه درخواست ارسال کنید. پنجره زمینه (context window) اجازه می‌دهد ۱۰۰,۰۰۰ توکن برای ترکیب پرامپت و تکمیل (completion) استفاده شود. اگر max_tokens را مشخص نکنید، محدودیت پیش‌فرض خروجی ۲,۰۴۸ توکن است.

Copycurl https://api.grokaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

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

از کتابخانه رسمی پایتون OpenAI برای ارتباط با API LLM بدون سانسور ما استفاده کنید. این روش در صورتی که با ادغام‌های استاندارد OpenAI آشنایی دارید، نیاز به تغییرات کد کمی دارد.

کلاینت را با URL پایه و کلید API خود مقداردهی دهید. کتابخانه فرمت‌دهی درخواست و تجزیه پاسخ را به‌طور خودکار مدیریت می‌کند. می‌توانید پارامترهایی مانند temperature و top_p را برای کنترل تصادفی بودن خروجی تنظیم کنید.

مدیریت خطا دقیقاً همان‌طور که انتظار می‌رود کار می‌کند. اگر اعتبارات از پیش پرداخت شده شما تمام شود، API خطای 402 را برمی‌گرداند. اگر کلید شما نامعتبر باشد، خطای 401 دریافت می‌کنید. این خطاها از محدودیت‌های نرخ متمایز هستند که کد وضعیت 429 را برمی‌گردانند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokaiuncensored.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 خود با استفاده از SDK استاندارد یکپارچه کنید. این سازگاری با جریان‌های کاری و کتابخانه‌های موجود مبتنی بر نود را تضمین می‌کند.

مشتری را با URL پایه و کلید API خود پیکربندی کنید. SDK درخواست‌های HTTP را مدیریت کرده و پاسخ‌های JSON را به‌طور کارآمد تجزیه می‌کند. می‌توانید پیام‌ها را مستقیماً به روش chat.completions.create ارسال کنید.

SDK پاسخ‌های استریم را پشتیبانی می‌کند که برای خروجی‌های طولانی مفید است. همچنین می‌توانید از function calling و حالت JSON برای تولید داده‌های ساختاریافته استفاده کنید. کتابخانه گزارش‌دهی استفاده از توکن و حالت‌های خطا را به صورت قابل اعتماد مدیریت می‌کند.

Copyimport OpenAI from "openai";

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

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

با تنظیم stream به true در درخواست خود، پخش زنده (streaming) را فعال کنید. این کار به جای یک شیء JSON واحد، رویدادهای ارسالی سرور (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)

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

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

خطای 401 نشان‌دهنده کلید API نامعتبر یا منقضی‌شده است. خطای 402 به این معنی است که اعتبار پیش‌پرداخت شما تمام شده است؛ برای ادامه با USDT یا USDC شارژ کنید. خطای 429 نشان می‌دهد که به محدودیت نرخ دسترسی پیدا کرده‌اید؛ چند ثانیه صبر کنید و دوباره تلاش کنید.

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