راهنمای یکپارچه‌سازی کلید API Kwen

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

از URL پایه و یک کلید API برای تمام درخواست‌ها استفاده کنید. ما از هدرهای استاندارد و کتابخانه‌های کلاینت پشتیبانی می‌کنیم.

• URL پایه: HTTPS://api.qwenapikey.com/v1
• هدر Auth: Authorization: Bearer

کلید API هنگام ثبت‌نام ایجاد می‌شود. آن را امن نگه دارید. می‌توانید آن را هر زمان از داشبورد خود تغییر دهید.

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

درخواست POST را به /v1/chat/completions ارسال کنید تا پاسخ دریافت کنید. از شناسه مدل "uncensored" استفاده کنید.

در اینجا یک مثال curl آورده شده است:

• Command: curl -X POST HTTPS://api.qwenapikey.com/v1/chat/completions -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}'

این یک شیء JSON شامل متن تولید شده برمی‌گرداند.

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

پکیج OpenAI Python را نصب کنید و آن را طوری پیکربندی کنید که به URL پایه ما اشاره کند. کلید خود را ارسال کنید و مدل را روی "uncensored" تنظیم کنید.

نمونه کد:

• pip install openai
• from openai import OpenAI
• client = OpenAI(base_url="HTTPS://api.qwenapikey.com/v1", api_key="YOUR_KEY")
• response = client.chat.completions.create(model="uncensored", messages=[{"role": "user", "content": "Test"}])

به پاسخ از طریق response.choices[0].message.content دسترسی پیدا کنید.

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

از SDK نود OpenAI استفاده کنید. URL پایه و کلید API را در آبجکت پیکربندی تنظیم کنید. مدل را به عنوان "uncensored" مشخص کنید.

نمونه کد:

• import OpenAI from 'openai';
• const openai = new OpenAI({ baseUrl: 'HTTPS://api.qwenapikey.com/v1', apiKey: 'YOUR_KEY' });
• const response = await openai.chat.completions.create({ model: 'uncensored', messages: [{ role: 'user', content: 'Test' }] });

متن را از شیء پاسخ بازیابی کنید.

پاسخ‌های استریم و توکن‌ها

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

نمونه کد:

• const stream = await client.chat.completions.create({ model: 'uncensored', messages: [{ role: 'user', content: 'Tell a story' }], stream: true });
• برای await (const chunk of stream) { console.log(chunk.choices[0].delta.content); }

برای آمار استفاده در قطعه آخر بررسی کنید.

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

خطای ۴۰۱ را برای کلیدهای نامعتبر، ۴۰۲ را برای اعتبار ناکافی و ۴۲۹ را برای محدودیت نرخ درخواست مدیریت کنید. پنجره زمینه ۱۰۰,۰۰۰ توکن است. حداکثر خروجی ۱۶,۰۰۰ توکن است. محدودیت درخواست ۳۰۰ در دقیقه است.

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

cURL

Copycurl https://api.qwenapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the endpoints for the qwen api key"}]
  }'

پایتون

Copyfrom openai import OpenAI

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