قیمت‌گذاری توکن‌های کلاد: مستندات سازگار با OpenAI

تنظیم URL پایه احراز هویت

ابتدا SDK خود را به URL پایه ما اشاره دهید و کلید API خود را در هدر احراز هویت ارسال کنید. ما احراز هویت ساده مبتنی بر هدر را نیاز داریم، بنابراین نیازی به جریان‌های OAuth پیچیده یا منطق مقداردهی اولیه خاص SDK ندارید. یک حساب کاربری از طریق Google یا ایمیل ایجاد کنید، سپس کلید خود را بلافاصله از داشبورد دریافت کنید. این کلید دسترسی به مدل بدون سانسور واحدی را که با شناسه 'uncensored' مشخص شده است، اعطا می‌کند. در صورت نیاز می‌توانید کلیدها را بچرخانید، اما در هر زمان فقط یک کلید فعال برای هر حساب وجود دارد. مطمئن شوید که کتابخانه کلاینت شما برای ارسال توکن Bearer به درستی پیکربندی شده است قبل از ارسال اولین درخواست.

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

درخواست‌های POST را به /v1/chat/completions با یک آرایه messages شامل پرامپت و دستورالعمل‌های system ارسال کنید. این نقطه پایدار پیک‌لودهای JSON سازگار با OpenAI را می‌پذیرد و به شما امکان می‌دهد سرویس ما را بدون بازنویسی کد در Cursor، Windsurf یا اسکریپت‌های سفارشی جایگزین کنید. مدل را به عنوان 'uncensored' مشخص کنید تا اطمینان حاصل کنید که خروجی LLM uncensored خاص ما را دریافت می‌کنید. می‌توانید خلاقیت را از طریق temperature و top_p کنترل کنید، یا با تنظیم temperature روی 0 نتایج قطعی را مجبور کنید. درخواست‌ها بلافاصله پردازش می‌شوند و شما تنها بابت مصرف واقعی توکن صورت‌حساب دریافت می‌کنید. خطاها و رد شدن‌ها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند.

پاسخ‌های استریم‌شده و مصرف توکن

استریمینگ را با تنظیم stream به true در بدنه درخواست فعال کنید. این کار رویدادهای Server-Sent (SSE) را برمی‌گرداند که رابط کاربری شما را به صورت بلادرنگ هنگام تولید توکن‌ها به‌روز می‌کنند. قطعه نهایی جریان شامل کل مصرف توکن برای درخواست است که به شما امکان می‌دهد هزینه‌ها را بدون پرس‌وجوی یک endpoint جداگانه برای مصرف، به دقت ردیابی کنید. استریمینگ برای پنجره‌های زمینه طولانی تا 100,000 توکن ایده‌آل است. می‌توانید قطعات محتوای delta را تجزیه کنید تا متن را همان‌طور که ظاهر می‌شود نمایش دهید. این رویکرد تأخیر ادراک‌شده را برای کاربران منتظر استدلال پیچیده یا خروجی‌های طولانی‌محتوا کاهش می‌دهد.

فراخوانی تابع و حالت JSON

از پارامتر tools برای تعریف طرحواره‌های تابع برای فراخوانی تابع استفاده کنید، یا response_format را روی json_object تنظیم کنید تا خروجی‌های JSON دقیق دریافت کنید. مدل از استخراج داده‌های ساختاریافته و اجرای پویای ابزار در همان پنجره زمینه پشتیبانی می‌کند. می‌توانید ابزارهای متعددی را در یک درخواست تعریف کنید و مدل بر اساس نیاز، فراخوانی‌های ابزار یا پاسخ‌های متنی مستقیم را برمی‌گرداند. این انعطاف‌پذیری API را برای ساخت عامل‌ها یا خودکارسازی گردش کارها مناسب می‌سازد. مطمئن شوید تعاریف تابع شما از فرمت OpenAI پیروی می‌کنند تا با کلاینت‌های استاندارد سازگار باشند.

قوانین محدودیت‌های نرخ و همزمانی

هر کلید API اجازه ۳۰۰ درخواست در دقیقه و تا ۸ درخواست همزمان را می‌دهد. حداکثر اندازه بدنه درخواست ۸ مگابایت است، که مقدار داده‌ای که می‌توانید در یک پرامپت واحد ارسال کنید را محدود می‌کند. اگر این محدودیت‌ها را تجاوز کنید، کد وضعیت ۴۲۹ را دریافت خواهید کرد که نشان می‌دهد به محدودیت نرخ رسیده‌اید. می‌توانید استفاده خود را از طریق پاسخ استریم یا انتهای نقطه /v1/models نظارت کنید. این محدودیت‌ها عملکرد پایدار را برای همه کاربران تضمین می‌کنند. پردازش دسته‌ای خود را به طور مناسب برنامه‌ریزی کنید تا از نازک‌شدن در زمان‌های اوج استفاده جلوگیری کنید.

مدیریت خطا و بازپرداخت‌ها

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

cURL

Copycurl https://api.claudetokenpricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate the cost for 100k tokens"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)