شروع سریع: ادغام API بدون سانسور

پیش‌نیازها و نصب SDK

API نیازمند یک کلید معتبر و یک SDK مدرن است. کتابخانه را برای زبان مورد نظر خود از طریق pip یا npm نصب کنید. ما از کتابخانه‌های کلاینت استاندارد OpenAI پشتیبانی می‌کنیم که احراز هویت و تجزیه JSON را به طور خودکار مدیریت می‌کنند.

اطمینان حاصل کنید که Python 3.8+ یا Node.js 18+ نصب شده است. SDKها مدیریت اتصال و منطق تلاش مجدد را برای شما انجام می‌دهند. این کار به طور قابل توجهی کدهای تکراری (boilerplate) را کاهش می‌دهد.

Copyfrom openai import OpenAI

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

پیکربندی URL پایه و کلید API

مشتری خود را به نقطه پایانی اختصاصی ما هدایت کنید. از URL پایه ارائه شده در داشبورد خود استفاده کنید. کلید API خود را در هدر Authorization ارسال کنید. این تضمین می‌کند که درخواست‌ها مستقیماً به زیرساخت بدون سانسور می‌رسند.

از URL پایه پیش‌فرض OpenAI استفاده نکنید. کلید شما در صورت مسیریابی نادرست شکست می‌خورد. URL پایه را در شیء پیکربندی SDK خود قبل از ارسال هرگونه داده تنظیم کنید.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

ارسال اولین درخواست تکمیل چت خود

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

بارگذاری را ساده نگه دارید. با یک پیام سیستمی و یک پیام کاربر شروع کنید. ساختار پاسخ را بررسی کنید تا مطمئن شوید با استاندارد OpenAI مطابقت دارد. این تأیید می‌کند که یکپارچه‌سازی شما به درستی کار می‌کند.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ablatedmodels.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) را فعال کنید. API قطعات را از طریق رویدادهای ارسالی سرور برمی‌گرداند. هر قطعه شامل متن ناقص یا داده‌های مصرف توکن است. این قطعات را جمع‌آوری کنید تا خروجی بلادرنگ را نمایش دهید.

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

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)

درک محدودیت‌های توکن و پنجره زمینه

پنجره زمینه (Context Window) در مجموع ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. این شامل توکن‌های ورودی و خروجی است. max_tokens را تنظیم کنید تا طول پاسخ محدود شود. حداکثر خروجی پیش‌فرض ۲,۰۴۸ توکن است اگر مشخص نشده باشد.

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

عیب‌یابی خطاهای رایج

ابتدا کلید API خود را بررسی کنید. خطای 401 نشان‌دهنده کلید نامعتبر یا منقضی شده است. خطای 402 به این معنی است که اعتبار پیش‌پرداخت شما تمام شده است. برای ادامه از طریق رمزارز شارژ کنید.

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