نصب SDK رسمی
ابتدا SDK رسمی پایتون OpenAI را در محیط خود نصب کنید. این کتابخانه درخواست‌های HTTP و سریال‌سازی JSON را برای شما مدیریت می‌کند.
- اجرا
pip install openaiدر ترمینال شما. - اطمینان حاصل کنید که از نسخه جدیدی از کتابخانه استفاده می‌کنید.
این وابستگی واحد به شما دسترسی به رابط کلایندر استاندارد را می‌دهد که در سراسر صنعت استفاده می‌شود.
پیکربندی base_url و کلید
مشتری خود را به URL پایه ما هدایت کنید و کلید API خود را برای احراز هویت تنظیم کنید. این تضمین می‌کند که تمام درخواست‌ها به سرور مدل بدون سانسور ما مسیریابی شوند.
استفاده https://api.qwenmaxapi.com/v1 به‌عنوان آدرس پایه (base URL). کلید خود را در دریافت کلید API صفحه را با استفاده از حساب گوگل یا ایمیل باز کنید. کلید بلافاصله پس از ثبت‌نام نمایش داده می‌شود.
اولین تکمیل چت خود را ارسال کنید
یک درخواست متنی ساده به /v1/chat/completions اندپوینت. مدل متن بدون محدودیت بر اساس پرامپت شما برمی‌گرداند.
شناسه مدل را استفاده کنید uncensored. API پارامترهای استاندارد مانند temperature و top_p. می‌توانید این‌ها را برای کنترل خلاقیت تنظیم کنید.
فعال‌سازی جریان‌سازی و مدیریت توکن‌ها
پخش زنده را فعال کنید تا توکن‌ها به محض تولید دریافت شوند. این کار تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد.
تنظیم stream=True در درخواست شما. سرور رویدادهای ارسالی سرور (SSE) ارسال می‌کند. جزئیات مصرف توکن در قطعه نهایی ظاهر می‌شوند.
استریم را در کد خود مدیریت کنید تا خروجی به صورت تدریجی نمایش داده شود.
بررسی حالت JSON و فراخوانی تابع
استفاده از حالت JSON برای خروجی داده‌های ساختاریافته. تنظیم response_format به {"type": "json_object"}. این امر تضمین می‌کند که مدل JSON معتبر را بازگرداند.
فعال‌سازی فراخوانی تابع با ارائه یک tools تعریف. مدل می‌تواند بر اساس زمینه پرامپت شما، ابزارها را فراخوانی کند. از tool_choice برای اجبار یا اجازه استفاده از ابزار.
محدودیت‌ها، خطاها و پنجره زمینه
Know your limits before scaling your integration. The context window is 100,000 tokens total.
حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است. شما ۳۰۰ درخواست در دقیقه به ازای هر کلید دریافت می‌کنید. هشت درخواست همزمان به ازای هر کلید مجاز است.
خطاهایی مانند 401 برای کلیدهای نامعتبر یا 402 برای اعتبار ناکافی را مدیریت کنید. خطاها رایگان هستند، بنابراین درخواست‌های نامعتبر اعتبار مصرف نمی‌کنند.
cURL
curl https://api.qwenmaxapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 arguments against cloud computing"}]
}'پایتون
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenmaxapi.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenmaxapi.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 = 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)