API مستندات و شروع سریع

احراز هویت و Base URL پیکربندی

اولین مرحله دریافت اعتبارنامه‌های شماست. از طریق Google یا ایمیل در صفحه دریافت کلید API ثبت‌نام کنید تا توکن خود را فوراً دریافت کنید. شماره تلفن لازم نیست. از این توکن برای احراز هویت هر درخواست استفاده کنید.

URL پایه خود را به HTTPS://api.lamaapikey.com/v1 تنظیم کنید. این تضمین می‌کند که تماس‌های شما به مدل اختصاصی uncensored ما هدایت می‌شوند. نیازی به مدیریت پروکسی‌ها یا تغییر نقاط پایانی برای مدل‌های مختلف ندارید.

Copycurl https://api.lamaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the current latency for my key."}]
  }'

چت تکمیل‌ها نقطه پایانی (POST /v1/chat/completions)

پیام‌های متنی را از طریق endpoint استاندارد chat-completations ارسال کنید. کلید API شما در هدر Authorization قرار می‌گیرد. شناسه مدل همیشه "uncensored" است.

این پیکربندی با هر کلاینت سازگار با OpenAI کار می‌کند. می‌توانید از SDKهای رسمی یا کتابخانه‌های HTTP مستقیماً استفاده کنید. API پاسخ‌های متنی را بر اساس پرامپت‌های شما برمی‌گرداند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.lamaapikey.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, و ابزارها

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

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

Copyimport OpenAI from "openai";

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

جریان‌سازی پاسخ‌ها و مصرف متادیتا

پخش زنده (Streaming) را با پارامتر stream فعال کنید. شما قطعات را همان‌طور که تولید می‌شوند دریافت می‌کنید. این کار تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد.

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

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)

JSON حالت و ساختاریافته خروجی‌ها

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

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

top_p را روی ۱.۰ برای حداکثر تنوع تنظیم کنید. دما را برای دقت تنظیم کنید. خلاقیت را با ساختار تعادل دهید.

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

پنجره زمینه: مجموعاً ۱۰۰,۰۰۰ توکن. حداکثر خروجی: ۱۶,۰۰۰ توکن. max_tokens پیش‌فرض ۲,۰۴۸ است اگر تنظیم نشده باشد. حد بدنه درخواست ۸ مگابایت است.

محدودیت نرخ: ۳۰۰ درخواست در دقیقه. همزمانی: ۸ درخواست همزمان. خطاها: ۴۰۱ به معنای کلید نامعتبر است. ۴۰۲ به معنای عدم اعتبار است. ۴۲۹ به معنای تجاوز از محدودیت نرخ است.

پرداخت $0.15 به ازای هر ۱ میلیون توکن ورودی. پرداخت $0.50 به ازای هر ۱ میلیون توکن خروجی. فقط شارژ با ارز دیجیتال.