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

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

از کلید API خود با آدرس پایه HTTPS://api.apiqwen.com/v1 استفاده کنید. این نقطه پایانی با SDKهای رسمی OpenAI و هر کلاینت سازگار دیگری کار می‌کند. کلید را در Authorization هدر. از URLهای واسطه ارائه‌دهندگان دیگر استفاده نکنید. خدمات ما مستقل است و مدل بدون سانسور اختصاصی خود را اجرا می‌کند. می‌توانید کلید خود را از طریق گوگل یا ایمیل در داشبورد ایجاد کنید. کلید بلافاصله پس از ثبت‌نام نمایش داده می‌شود. نیاز به شماره تلفن نیست.

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

درخواست‌های POST را به /v1/chat/completions ارسال کنید. از شناسه مدل "uncensored" استفاده کنید. این نقطه پایدار پیام‌های چت استاندارد را می‌پذیرد. فقط پاسخ‌های متنی برمی‌گرداند. جاسازی یا تصویر پشتیبانی نمی‌شود. پارامترهایی مانند temperature و top_p را پیکربندی کنید. response_format را روی json_object برای داده‌های ساختاریافته تنظیم کنید. فراخوانی تابع از طریق tools در دسترس است. درخواست‌ها روی سرورهای اختصاصی ما پردازش می‌شوند. این تضمین‌کننده تأخیر ثابت است. URL پایه را به دقت بررسی کنید. URLهای نادرست باعث خطاهای 404 می‌شوند.

جزئیات مدل و محدودیت‌ها

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

جریان‌سازی و استفاده توکن

با تنظیم stream به true، پخش زنده (streaming) را فعال کنید. API رویدادهای ارسالی سرور را برمی‌گرداند. مصرف توکن در آخرین قطعه ظاهر می‌شود. این به نمایش بلادرنگ امکان می‌دهد. این را برای رابط‌های چت استفاده کنید. این امر تأخیر ادراکی را کاهش می‌دهد. قطعات را به ترتیب بخوانید. پاسخ‌های ناقص را با دقت مدیریت کنید. حالت JSON با پخش زنده کار می‌کند. فراخوانی‌های تابع نیز پخش می‌شوند. تعداد توکن‌ها را پایش کنید. هزینه‌ها بر اساس هر میلیون توکن محاسبه می‌شود. ورودی $0.15 است. خروجی $0.50 است. موجودی مصرف را ردیابی می‌کند. صورتحساب کریپتو اعمال می‌شود. با USDT یا USDC شارژ کنید.

مدیریت خطا و محدودیت نرخ

خطاهای 401 را با بررسی کلید خود مدیریت کنید. مطمئن شوید که هدر Authorization صحیح است. از خطاهای 402 برای تشخیص موجودی کم استفاده کنید. برای ادامه از طریق ارز دیجیتال شارژ کنید. خطاهای 429 نشان‌دهنده محدودیت نرخ هستند. قبل از تلاش مجدد صبر کنید. بازگشت نمایی بهترین عملکرد را دارد. محدودیت‌های همزمانی را بررسی کنید. از 8 درخواست فراتر نروید. اندازه بدنه باید زیر 8 مگابایت باشد. JSON نامعتبر باعث خطاهای 400 می‌شود. شناسه‌های مدل ناشناخته 400 برمی‌گردانند. خطاها را برای اشکال‌زدایی لاگ کنید. صفحه پشتیبانی مشکلات صورتحساب را حل می‌کند. اعتبار منقضی نمی‌شود. بازگشت وجهی صادر نمی‌شود. خطاها رایگان هستند.

شروع سریع SDK پایتون

بسته openai را نصب کنید. URL پایه را تنظیم کنید. کلید API خود را وارد کنید. chat.completions.create را فراخوانی کنید. از مدل "uncensored" استفاده کنید. stream را روی true تنظیم کنید. روی قطعات تکرار کنید. توکن‌ها را چاپ کنید. استثناها را مدیریت کنید. کلاینت را ببندید. این با کد موجود کار می‌کند. URL پایه را جایگزین کنید. کلید API را ایمن نگه دارید. از متغیرهای محیطی استفاده کنید. با پرامپت‌های کوچک تست کنید. مصرف توکن را بررسی کنید. هزینه‌ها را مانیتور کنید. به اعتبارات پولی ارتقا دهید. پرداخت‌های ارز دیجیتال فقط. USDT یا USDC. راه‌اندازی سریع.

cURL

Copycurl https://api.apiqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python function"}]
  }'

پایتون

Copyfrom openai import OpenAI

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