راهنمای یکپارچه‌سازی

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

درخواست‌های شما به https://api.modelunrestricted.com/v1. کلید API خود را در Authorization header. ما برای ثبت‌نام به شماره تلفن نیاز نداریم. ورود با گوگل یا ایمیل دسترسی فوری به شما می‌دهد.

Copycurl https://api.modelunrestricted.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple python loop"}]
  }'

کلید بلافاصله ایجاد می‌شود. آن را امن نگه دارید. این حساب و اعتبارات شما را شناسایی می‌کند. خطاهایی مانند 401 به این معنی است که کلید اشتباه است. داشبورد خود را بررسی کنید.

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

پیام‌ها را به POST /v1/chat/completions. این روش استاندارد برای دریافت پاسخ‌های متنی است. شناسه مدل ما uncensored. محتوای بزرگسالان قانونی را بدون رد شدن پاسخ می‌دهد.

Copyfrom openai import OpenAI

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

نام مدل را به صراحت تنظیم کنید. از temperature برای خلاقیت. مقدار top_p برای تنوع. API خروجی JSON ساختاریافته برمی‌گرداند. آن را در کد خود تجزیه کنید.

پاسخ‌های جریان‌دار با SSE

استریمینگ را با تنظیم stream: true. توکن‌ها را همان‌طور که تولید می‌شوند دریافت می‌کنید. این کار تأخیر ادراک‌شده را کاهش می‌دهد. برای کاربران سریع‌تر به نظر می‌رسد.

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 در اکثر SDKها استاندارد است. از آن برای رابط‌های بلادرنگ استفاده کنید.

فراخوانی تابع و ابزارها

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

Copyimport OpenAI from "openai";

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

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

اجبار حالت JSON

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

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

Limits, errors, and context

پنجره زمینه (Context Window) ما در مجموع ۱۰۰,۰۰۰ توکن است. حداکثر خروجی ۱۶,۰۰۰ توکن است. خطاها و رد شدن‌ها هزینه‌ای ندارند. کد ۴۰۲ یعنی اعتبار ندارید. با رمزارز شارژ کنید. کد ۴۲۹ یعنی محدودیت نرخ (Rate Limit) را عبور کرده‌اید. صبر کنید و دوباره تلاش کنید. ما ۳۰۰ درخواست در دقیقه به ازای هر کلید را مجاز می‌دانیم. هشت درخواست همزمان مشکلی ندارد. پیکربندی‌های (Payloads) خود را زیر ۸ مگابایت نگه دارید. این موضوع پایداری را تضمین می‌کند. هیچ هزینه اشتراکی اعمال نمی‌شود. اعتبارها منقضی نمی‌شوند. پنجره را به درستی استفاده کنید.