راهنمای شروع سریع

پیش‌نیازها: کلید API خود را دریافت کنید

ابتدا اعتبار دسترسی خود را در داشبورد امن کنید. می‌توانید با گوگل وارد شوید یا از ایمیل و رمز عبور استفاده کنید. برای این تنظیم حساب حداقلی، نیازی به شماره تلفن نیست. پس از ثبت‌نام، کلید API منحصر‌به‌فرد شما بلافاصله نمایش داده می‌شود. شما فقط به یک کلید فعال برای هر حساب نیاز دارید، زیرا ایجاد کلید جدید، کلید قبلی را جایگزین می‌کند. این رویکرد مستقیم تضمین می‌کند که می‌توانید بدون اصطکاک اداری یا مراحل تأیید اضافی که اغلب فرآیندهای توسعه‌دهندگان را به تأخیر می‌اندازند، شروع به یکپارچه‌سازی کنید.

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

کلاینت خود را به نقطه پایانی خاص ما تنظیم کنید. از https://api.aisenzalimitietici.com/v1 به‌عنوان آدرس پایه (base URL). کلید خود را در Authorization هدر با Bearer prefix. این فرمت استاندارد با ابزارهای موجود سازگار است. نیازی به تغییر منطق مسیریابی پیچیده ندارید. فقط URL پایه را در پیکربندی SDK خود به‌روزرسانی کنید و کلید خود را تزریق کنید. این راه‌اندازی ساده به شما اجازه می‌دهد از همان کتابخانه‌های کلاینتی که برای مدل‌های دیگر به آن‌ها اعتماد دارید، بهره‌مند شوید.

Copycurl https://api.aisenzalimitietici.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?"}]
  }'

ارسال اولین درخواست شما

یک تکمیل چت استاندارد را اجرا کنید تا اتصال را بررسی کنید. یک درخواست POST به /v1/chat/completions با شناسه مدل uncensored. پرامپت سیستم را برای تعریف رفتار قرار دهید. مدل پاسخی را بدون رد شدن‌های معمول شرکتی برمی‌گرداند. می‌توانید متن ارسال کرده و بلافاصله متن دریافت کنید. این تعامل مستقیم تأیید می‌کند که کلید شما معتبر است و اتصال پایدار است. بررسی کنید content field in the response to see the generated text.

Copyfrom openai import OpenAI

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

پاسخ‌های استریم (SSE)

استریمینگ را با تنظیم stream: true در درخواست شما. API یک جریان رویدادهای ارسالی سرور را به جای یک شیء JSON واحد برمی‌گرداند. هر قطعه حاوی متن جزئی است تا زمانی که آخرین توکن ارسال شود. این رویکرد تأخیر ادراک‌شده را به طور قابل توجهی کاهش می‌دهد. می‌توانید توکن‌ها را همان‌طور که تولید می‌شوند به کاربر نمایش دهید. قطعه آخر همچنین شامل آمار مصرف نهایی است. این ویژگی برای ساخت رابط‌های کاربری چابک و روان ضروری است.

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)

پارامترهای پیشرفته (Temperature، Top-p)

خلاقیت و قطعیت خروجی را کنترل کنید. تنظیم temperature به تغییر تصادفی‌سازی. مقادیر پایین‌تر نتایج سازگارتری تولید می‌کنند. مقادیر بالاتر تشویق به پاسخ‌های متنوع و خلاقانه می‌کند. استفاده top_p برای کنترل نمونه‌گیری هسته. تنظیم response_format به json_object اگر به داده‌های ساختاریافته نیاز دارید. همچنین می‌توانید از stop sequences برای توقف تولید. این پارامترها کنترل دقیقی بر نحوه ساخت پاسخ‌ها توسط مدل به شما می‌دهند.

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

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

Node.js

Copyimport OpenAI from "openai";

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