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

نصب و پیکربندی SDK

ابتدا SDK رسمی OpenAI برای زبان مورد نظر خود را نصب کنید. API ما با هر کلاینت استاندارد سازگار با OpenAI کار می‌کند، بنابراین نیازی به کتابخانه سفارشی ندارید. متغیر base_url به HTTPS://api.ollamaapipricing.com/v1 و کلید API را از داشبورد حساب کاربری خود ارائه دهید. شناسه مدل uncensored. این مدل واحد تمام نیازهای تولید متن شما را بدون منطق مسیریابی مدیریت می‌کند.

احراز هویت به یک کلید معتبر نیاز دارد. اگر خطای 401 را مشاهده می‌کنید، کلید شما نامعتبر است. اگر خطای 402 را مشاهده می‌کنید، اعتباری ندارید. برای ادامه با USDT یا USDC شارژ کنید. آدرس پایه تضمین می‌کند که درخواست‌های شما مستقیماً به سرورهای ما می‌رسند.

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

یک درخواست POST به /v1/chat/completions با پرامپت. مدل فقط با متن پاسخ می‌دهد. می‌توانید طول پاسخ را با max_tokens. حداکثر خروجی پیش‌فرض ۲,۰۴۸ توکن است مگر اینکه خلاف آن را مشخص کنید. پنجره زمینه از مجموعاً ۱۰۰,۰۰۰ توکن برای ورودی و خروجی پشتیبانی می‌کند.

از مثال زیر برای بررسی اتصال و کیفیت پاسخ استفاده کنید. مقدار messages آرایه متناسب با مورد استفاده خود.

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

فعال‌سازی جریان‌سازی و ابزارها

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

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

Copyfrom openai import OpenAI

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

مدیریت پاسخ‌های حالت JSON

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

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

Copyimport OpenAI from "openai";

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

درک مصرف توکن

قیمت‌گذاری $0.15 به ازای هر ۱ میلیون توکن ورودی و $0.50 به ازای هر ۱ میلیون توکن خروجی, خطاها و رد شدن‌ها رایگان هستند. اعتبار فقط برای تولید توکن موفق هزینه می‌شود. اعتبار پیش‌پرداخت هرگز منقضی نمی‌شود. این مدل برای استفاده بزرگسالان قانونی بدون سانسور است، به این معنی که رد شدن‌های کمتر برای موضوعات استاندارد.

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

Limits and Errors

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

خطاها را به شیوه‌ای مناسب مدیریت کنید. خطای ۴۰۱ یعنی کلید نامعتبر است. خطای ۴۰۲ یعنی اعتبار ناکافی است. خطای ۴۲۹ یعنی محدودیت نرخ اعمال شده است. API تضمین‌های SLA یا زمان فعالیت ارائه نمی‌دهد. برای تلاش‌های مجدد خود برنامه‌ریزی کنید.

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)