شروع سریع API هوش مصنوعی Kwen

تنظیم احراز هویت و URL پایه

ابتدا کلید API خود را از داشبورد تولید کنید. URL پایه https://api.qwenaiapi.com/v1 و کلید خود را در Authorization header. این پیکربندی با هر کلاینت SDK استاندارد OpenAI بدون تغییر کد کار می‌کند. شما یک کلید فعال برای هر حساب دریافت می‌کنید؛ تولید یک کلید جدید، بلافاصله کلید قبلی را نامعتبر می‌کند. برای ثبت‌نام به شماره تلفن نیاز نیست.

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

یک درخواست POST به /v1/chat/completions با کلید و شناسه مدل. شناسه مدل uncensored و به پیام‌های چت استاندارد پاسخ می‌دهد. می‌توانید اتصال را با یک دستور سیستم ساده برای بررسی تأخیر و قالب پاسخ آزمایش کنید. خطاهایی مانند 401 نشان‌دهنده کلید نامعتبر و 402 نشان‌دهنده اتمام اعتبار پیش‌پرداخت شما است.

Copycurl https://api.qwenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this pull request diff"}]
  }'

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

از کلاینت رسمی پایتون برای تعامل با اندپوینت استفاده کنید. URL پایه و کلید API را در پارامترهای مقداردهی اولیه تنظیم کنید. SDK تگ‌گذاری و سریال‌سازی JSON را به صورت خودکار مدیریت می‌کند. این رویکرد منطق برنامه موجود شما را در حالی که ارائه‌دهنده مدل زیرین را تغییر می‌دهید، حفظ می‌کند. کلاینت از عملیات همزمان و ناهمزمان پشتیبانی می‌کند.

Copyfrom openai import OpenAI

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

کلاینت Node.js را با URL پایه و کلید خود مقداردهی اولیه کنید. بسته از درخواست‌های تکمیل چت استاندارد پشتیبانی می‌کند. می‌توانید شناسه مدل را پیکربندی کنید تا مطمئن شوید که به انتهای‌گاه بدون سانسور متصل می‌شوید. این ادغام برای برنامه‌های سمت سرور که به دسترسی برنامه‌نویسی نیاز دارند ایده‌آل است. SDK مدیریت پویایی اتصال را برای درخواست‌های با حجم بالا به‌طور کارآمد انجام می‌دهد.

Copyimport OpenAI from "openai";

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

پاسخ‌های استریم

با تنظیم stream پارامتر را true تنظیم کنید. رویدادهای ارسال‌شده توسط سرور (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 پشتیبانی می‌کند. می‌توانید تا ۱۶,۰۰۰ توکن خروجی را در هر درخواست ارسال کنید. محدودیت‌های نرخ اجازه ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان را در هر کلید می‌دهند. بدنه‌های درخواست به ۸ MB محدود می‌شوند. درک این حدود به شما کمک می‌کند درخواست‌ها را به صورت موثر دسته‌بندی کنید و از خطاهای 429 جلوگیری کنید. خطاها اعتبار از پیش پرداخت شده شما را مصرف نمی‌کنند.