راهنمای شروع سریع اندپوینت سازگار با OpenAI

پیش‌نیازها: Python یا Node.js

نصب رسمی openai بسته را برای محیط زمان اجرا خود قبل از ادامه نصب کنید.

کاربران پایتون به نسخه 1.0.0 یا جدیدتر نیاز دارند. توسعه‌دهندگان Node به نسخه 4.0.0 یا جدیدتر نیاز دارند. هر دو نسخه از ساختار استاندارد chat-completions پشتیبانی می‌کنند.

نیازی به وابستگی‌های اضافی نیست. SDK سریال‌سازی JSON و انتقال HTTP را به صورت خودکار مدیریت می‌کند.

base_url و کلید API را پیکربندی کنید

مشتری SDK خود را به URL پایه ما اشاره دهید و کلید تولیدشده خود را ارائه دهید.

استفاده https://api.openaicompatibleendpoint.com/v1 به عنوان URL پایه. کلید API را به مقداری که در داشبورد خود نشان داده شده تنظیم کنید.

• پایتون: base_url="https://api.openaicompatibleendpoint.com/v1"
• Node: baseURL: "https://api.openaicompatibleendpoint.com/v1"

این پیکربندی با هر کلایتی که با SDK سازگار با OpenAI کار می‌کند، سازگار است. برای بقیه منطق برنامه نیازی به تغییر کد نیست.

اولین تکمیل چت

یک درخواست POST به /v1/chat/completions با پیام‌های سیستم و کاربر خود.

شناسه مدل uncensored. این مدل برای محتوای بزرگسالان یا موضوعات بحث‌برانگیز قانونی بدون رد پاسخ می‌دهد.

• پنجره زمینه: مجموعاً ۱۰۰,۰۰۰ توکن.
• حداکثر خروجی: ۱۶,۰۰۰ توکن.

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

استریمینگ و فراخوانی تابع را فعال کنید

استریمینگ را با تنظیم stream: true در پارامترهای درخواست.

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

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

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

API کدهای وضعیت HTTP استاندارد را برای مشکلات رایج برمی‌گرداند.

• 401: کلید API نامعتبر. داشبورد خود را بررسی کنید.
• 402: اعتبار ناکافی. با USDT یا USDC شارژ کنید.
• 429: تجاوز از محدودیت نرخ. شما مجاز به ۳۰۰ درخواست در دقیقه هستید.

اگر از محدودیت خروجی ۱۶,۰۰۰ توکن تجاوز کنید، پاسخ قطع خواهد شد. پنجره زمینه شامل توکن‌های پرامپت و تکمیل (completion) می‌شود.

قیمت‌گذاری و محدودیت‌ها

فقط بابت آنچه استفاده می‌کنید پرداخت کنید. توکن‌های ورودی ۰.۱۵ دلار به ازای ۱ میلیون هزینه دارند. توکن‌های خروجی ۰.۵۰ دلار به ازای ۱ میلیون هزینه دارند.

اعتبار پیش‌پرداخت هرگز منقضی نمی‌شود. بازپرداخت صادر نمی‌شود، اما شارژ‌های دوگانه از طریق پشتیبانی اصلاح می‌شوند.

شارژ فقط با ارز دیجیتال. ارزهای قابل قبول USDT (TRC20) و USDC (Base) هستند. حداقل شارژ ۲۰ دلار است. اعتبار هدیه بسته به مبلغ از +۵٪ تا +۱۵٪ متغیر است.

cURL

Copycurl https://api.openaicompatibleendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return list of supported file formats"}]
  }'

پایتون

Copyfrom openai import OpenAI

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