URL پایه و احراز هویت
از URL پایه و یک کلید API معتبر برای اتصال کلاینت خود استفاده کنید. نقطه پایانی https://api.qwencodeapikey.com/v1. باید کلید خود را در Authorization هدر هر درخواست. این تضمین می‌کند که سرویس حساب اعتبار پیش‌پرداخت شما را به درستی شناسایی می‌کند.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
می‌توانید کلیدی را از طریق Google یا ایمیل در صفحه ثبت‌نام ایجاد کنید. کلید بلافاصله ظاهر می‌شود. آن را امن نگه دارید، زیرا کنترل هزینه‌های شما را بر عهده دارد.
نقطه پایانی تکمیل چت
پیام‌ها را به /v1/chat/completions اندپوینت برای دریافت پاسخ‌های متنی. این رابط استاندارد برای اکثر SDKهای OpenAI است. شما model به عنوان uncensored و یک لیست از پیام‌ها را در messages آرایه. API ورودی شما را پردازش کرده و تکمیل تولید شده را برمی‌گرداند.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
کتابخانه مشتری به URL پایه صحیح اشاره می‌کند. شناسه مدل uncensored مدل وزن‌دار باز را فعال می‌کند که برای کاهش رد کردن‌ها تنظیم شده است. این مدل نوبت‌های مکالمه را مانند هر API چت دیگری مدیریت می‌کند.
نقطه پایانی مدل‌ها
پرس‌وجو GET /v1/models به بررسی مدل‌های موجود و جزئیات آن‌ها. این نقطه پایان فهرستی از مدل‌های قابل دسترسی برای کلید شما را بازگردانده و ارسال می‌کند. این به شما کمک می‌کند تا uncensored مدل فعال است و برای درخواست‌ها آماده است. این را برای اشکال‌زدایی پیکربندی‌های کلاینت قبل از ارسال پیکربندی‌های کامل استفاده کنید.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
ساختار پاسخ را بررسی کنید تا اطمینان حاصل کنید که SDK لیست مدل‌ها را به درستی تجزیه می‌کند. این نقطه پایانی اعتبار مصرف نمی‌کند و برای بررسی‌های اولیه ایمن است.
پارامترهای درخواست و جریان‌دهی
پشتیبانی از پارامترهای استاندارد مانند temperature, top_p, stop، و seed. استریم‌دهی را با تنظیم stream: true. API توکن‌ها را از طریق رویدادهای ارسالی سرور (SSE) ارسال می‌کند. آمار مصرف توکن در آخرین قطعه جریان ظاهر می‌شود. این امکان نمایش بلادرنگ متن تولیدشده را فراهم می‌کند.
stream = 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)
تنظیم max_tokens برای کنترل طول خروجی. پیش‌فرض ۲,۰۴۸ توکن است. می‌توانید این مقدار را تا ۱۶,۰۰۰ توکن در هر درخواست افزایش دهید. پارامترها را تنظیم کنید تا تعادل بین خلاقیت و دقت در پاسخ‌های خود ایجاد کنید.
محدودیت‌های نرخ و محدودیت‌ها
هر کلید اجازه ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان را می‌دهد. حداکثر حجم بدنه درخواست ۸ مگابایت است. این محدودیت‌ها از سوءاستفاده جلوگیری کرده و عملکرد پایدار را تضمین می‌کنند. در صورت عبور از نرخ مجاز، خطای ۴۲۹ دریافت می‌کنید. منطق کلاینت خود را برای مدیریت تلاش مجدد با بازگشت نمایی تنظیم کنید.
پنجره زمینه (Context Window) در مجموع ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. این شامل ورودی (Prompt) و خروجی (Completion) است. زمینه‌های بزرگ نیاز به مدیریت دقیق توکن دارند تا در محدودیت‌ها بمانید.
حالت JSON و فراخوانی تابع
استفاده response_format: {"type": "json_object"} برای خروجی ساختاریافته. این تضمین می‌کند که مدل JSON معتبر برمی‌گرداند، که برای یکپارچه‌سازی برنامه‌ای مفید است. فراخوانی تابع از طریق tools پارامتر. ابزارها را در فرمت استاندارد OpenAI تعریف کنید. مدل توابع را در صورت نیاز فراخوانی خواهد کرد.
خطاها و رد شدن درخواست‌ها اعتبار مصرف نمی‌کنند. این حتی اگر مدل یک درخواست را به دلیل محدودیت سخت محتوا رد کند نیز اعمال می‌شود. شما فقط برای مصرف واقعی توکن پرداخت می‌کنید. اعتبار هرگز منقضی نمی‌شود، بنابراین می‌توانید هر زمان که مناسب است شارژ کنید.
مدیریت خطا و مصرف
خطاهای HTTP را به صورت ایمن مدیریت کنید. خطای 401 نشان‌دهنده کلید API نامعتبر یا منقضی شده است. خطای 402 به معنای تمام شدن اعتبار پیش‌پرداخت شماست. خطای 429 نشان‌دهنده تجاوز از محدودیت نرخ است. بدنه پاسخ را برای پیام‌های خطای دقیق بررسی کنید.
مصرف بر اساس کلید ردیابی می‌شود. یک کلید فعال برای هر حساب، صورت‌حساب را ساده می‌کند. اگر اشتباهی مانند شارژ دوباره رخ داد، از صفحه پشتیبانی استفاده کنید. اعتبار بازگردانده نمی‌شود اما معتبر باقی می‌ماند. خطاها رایگان هستند، بنابراین درخواست‌های ناموفق موجودی شما را کاهش نمی‌دهند.
خلاصه و بهترین شیوه‌ها
با URL پایه و یک کلید معتبر شروع کنید. از uncensored شناسه مدل را برای رد شدن کمتر استفاده کنید. پاسخ‌ها را استریم کنید تا تجربه کاربری بهتری داشته باشید. محدودیت‌های نرخ را برای جلوگیری از وقفه‌ها نظارت کنید. از حالت JSON برای داده‌های ساختاریافته استفاده کنید. خطاها را مدیریت کنید تا قابلیت اطمینان حفظ شود. اعتبار پیش‌پرداخت است و هرگز منقضی نمی‌شود. هر زمان که نیاز بود با کریپتو شارژ کنید. این API به راحتی در کدهای موجود OpenAI جای می‌گیرد. نیاز به SDK جدیدی نیست. فقط URL پایه و کلید را تغییر دهید.
