مستندات API

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

اتصال به https://api.tokenllm.cc/v1 با استفاده از کلید API منحصر به فرد خود. این base URL با هر SDK استاندارد OpenAI کار می‌کند با تنظیم base_url متغیر. شما یک کلید فعال در هر حساب کاربری دریافت می‌کنید؛ تولید کلید جدید جایگزین کلید قبلی می‌شود. احراز هویت بر اساس Authorization: Bearer <key> header. ما پرامپت‌های شما را برای آموزش ردیابی نمی‌کنیم و می‌توانید بدون شماره تلفن با گوگل یا ایمیل ثبت‌نام کنید. خطاها و رد درخواست‌ها صفر توکن مصرف می‌کنند، بنابراین شما فقط برای استنتاج واقعی پرداخت می‌کنید.

نقطه پایانی تکمیل گفتگو

متن را به POST /v1/chat/completions برای تولید پاسخ‌ها. این اندپوینت کارکردهای متن-ورودی، متن-خروجی را با مدل بدون سانسور ما مدیریت می‌کند. برای وظایف چت استاندارد به امبدینگ‌ها یا تولید تصویر نیاز ندارید. شناسه مدل همیشه "uncensored" است. درخواست‌ها روی سرورهای خود ما پردازش می‌شوند که تضمین می‌کند هیچ فیلتر شخص ثالثی خروجی شما را تغییر نمی‌دهد. پیکربندی خود را زیر 8 مگابایت نگه دارید تا از مشکلات بریدگی جلوگیری شود.

پارامترهای الزامی و اختیاری

شامل یک messages آرایه شامل تاریخچه مکالمه خود تنظیم کنید. model to "uncensored" to ensure correct routing. You can adjust temperature برای خلاقیت یا top_p برای تنوع. از max_tokens برای محدود کردن خروجی در ۱۶,۰۰۰ توکن، یا پیش‌فرض ۲,۰۴۸. پنجره زمینه از مجموع ۱۰۰,۰۰۰ توکن برای پرامپت و تکمیل پشتیبانی می‌کند. پارامترهای اختیاری مانند seed و stop کنترل دقیقی بر تولید به شما می‌دهند.

پاسخ‌های استریم از طریق SSE

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

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

ابزارها را در تعریف کنید tools پارامتر را برای قابلیت‌های فراخوانی تابع تنظیم کنید. مدل می‌تواند JSON ساختاریافته خروجی دهد وقتی که response_format به {"type": "json_object"}. این اطمینان حاصل می‌کند که تجزیه‌ی قابل اعتمادی برای برنامه‌های downstream وجود دارد. می‌توانید مشخص کنید tool_choice برای اجبار یا اجازه انتخاب خودکار. این ویژگی‌ها در همان مدل uncensored کار می‌کنند، بنابراین نیازی به ارائه‌دهنده خروجی ساختاریافته جداگانه ندارید.

مدیریت خطا و مصرف توکن

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

cURL

Copycurl https://api.tokenllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current price of one llm token"}]
  }'

پایتون

Copyfrom openai import OpenAI

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