مستندات API و نقاط پایانی

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

API نیازمند یک کلید معتبر برای هر درخواست است. شما این کلید را به سرعت هنگام ثبت‌نام با Google یا آدرس ایمیل ایجاد می‌کنید. کلید را در Authorization هدر با استفاده از Bearer scheme. URL پایه برای همه درخواست‌ها HTTPS://api.qwenaipricing.com/v1. این URL با SDKهای رسمی OpenAI و هر کلاینت سازگار با به‌روزرسانی ساده پیکربندی پایه کار می‌کند.

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

نقطه پایانی اصلی POST /v1/chat/completions. یک بدنه JSON با یک messages آرایه و یک model فیلد. شناسه مدل را روی "uncensored" تنظیم کنید تا به مدل زبانی بزرگ بهینه‌سازی شده برای خروجی‌های نامحدود دسترسی پیدا کنید. می‌توانید نقش‌های system، user و assistant را تعریف کنید تا زمینه مکالمه خود را ساختاردهی کنید.

Copycurl https://api.qwenaipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
  }'

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

یکپارچه‌سازی SDK Python

از رسمی openai پکیج پایتون برای تعامل با API. کلاینت را با ارائه کلید API و تنظیم URL پایه به نقطه پایانی ما مقداردهی اولیه کنید. این به شما اجازه می‌دهد تا از روش‌های آشنا مانند chat.completions.create() بدون بازنویسی منطق کلاینت. کتابخانه به‌طور خودکار سریال‌سازی JSON و تجزیه پاسخ‌ها را مدیریت می‌کند.

Copyfrom openai import OpenAI

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

پیام‌های خود را به صورت لیستی از دیکشنری‌ها ارسال کنید. SDK از تمام پارامترهای استاندارد مانند temperature و top_p پشتیبانی می‌کند. این رویکرد سازگاری با کدهای موجود که یک رابط سازگار با OpenAI را انتظار دارند را تضمین می‌کند.

یکپارچه‌سازی SDK Node.js

SDK Node.js مشابه نسخه Python کار می‌کند. پکیج openai بسته را پیکربندی کنید و URL پایه و کلید API را تنظیم کنید. سپس می‌توانید با پارامترهای دلخواه خود به نقطه پایانی تکمیل مکالمه (chat completions) درخواست بفرستید. این روش برای برنامه‌های سمت سرور یا خدمات بک‌اند که نیاز به تولید متن به‌صورت ناهمگام دارند، ایده‌آل است.

Copyimport OpenAI from "openai";

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

جریان پاسخ یا وعده (promise) را برای پردازش توکن‌های تولیدشده مدیریت کنید. SDK اتصال HTTP و مدیریت خطاها را برای شما انجام می‌دهد. همچنین می‌توانید از GET /v1/models اندپوینت برای بررسی شناسه مدل موجود.

پخش زنده و مصرف

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

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)

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

محدودیت‌ها، خطاها و پنجره زمینه

مدل از پنجره زمینه ۱۰۰,۰۰۰ توکن برای ترکیب prompt و completion پشتیبانی می‌کند. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. اگر تنظیم نکنید max_tokens, حد ۲,۰۴۸ توکن است. شما به ۳۰۰ درخواست در دقیقه و ۸ درخواست هم‌زمان به ازای هر کلید محدود هستید. خطای ۴۲۹ نشان می‌دهد که از این محدودیت‌ها تجاوز کرده‌اید. درخواست‌هایی که دارای خطا یا رد هستند، اعتبار مصرف نمی‌کنند. API تضمین‌های SLA یا گواهینامه‌ای ارائه نمی‌دهد.