مستندات API Kwen: شروع سریع

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

استفاده https://api.qwenapidocumentation.com/v1 به‌عنوان آدرس پایه (base URL). برای احراز هویت، کلید API خود را در Authorization هدر.

با ثبت‌نام از طریق گوگل یا ایمیل، کلید خود را بلافاصله دریافت کنید.

نقطه پایانی تکمیل چت (/v1/chat/completions)

درخواست‌های POST را به /v1/chat/completions با شناسه مدل uncensored. نقطه پایانی پیام‌های چت استاندارد را می‌پذیرد و متن برمی‌گرداند.

• ورودی: بدنه JSON با messages آرایه.
• خروجی: پاسخ متن توکن‌سازی شده.

مدل ما برای پاسخ دادن بدون رد محتوا برای استفاده بزرگسالان قانونی تنظیم شده است.

یکپارچه‌سازی SDK پایتون

پکیج رسمی پایتون OpenAI را نصب کنید. URL پایه و کلید API را قبل از راه‌اندازی کلایتن تنظیم کنید.

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

این پیکربندی تضمین می‌کند که کد کلاینت شما دقیقاً همان‌طور که برای سایر ارائه‌دهندگان بزرگ کار می‌کند، کار می‌کند.

استفاده از SDK Node.js

از openai پکیج Node.js. کلاینت را با کلید API منحصر‌به‌فرد و URL پایه ما پیکربندی کنید.

• محدودیت نرخ: ۳۰۰ درخواست در دقیقه برای هر کلید.
• همزمان: ۸ درخواست همزمان.

این امکان برای برنامه‌های با ظرفیت بالا فراهم می‌شود بدون نیاز به منطق پیچیده تلاش مجدد.

پاسخ‌های جریان‌دار با SSE

استریمینگ را با تنظیم stream: true. API رویدادهای ارسال سرور (SSE) را برمی‌گرداند.

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

این برای رابط‌های چتی که کاربران در آن‌ها بازخورد فوری انتظار دارند، ایده‌آل است.

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

خطاهای HTTP استاندارد را مدیریت کنید. 401 کلید نامعتبر را نشان می‌دهد. 402 به معنای عدم وجود اعتبار است. 429 یک محدودیت نرخ است.

• بدنه درخواست: حداکثر 8 مگابایت.
• رد شدن‌ها: رایگان اگر محتوا محدودیت سخت را نقض کند.

خطاها از اعتبار پیش‌پرداخت شما مصرف نمی‌کنند. پنجره زمینه 100,000 توکن است.

cURL

Copycurl https://api.qwenapidocumentation.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the area of a circle with radius five"}]
  }'

پایتون

Copyfrom openai import OpenAI

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