دليل تكامل مفتاح واجهة برمجة تطبيقات Qwen

عنوان URL الأساسي والمصادقة

استخدم عنوان URL الأساسي ومفتاح API المقدمين لجميع الطلبات. ندعم الرؤوس القياسية ومكتبات العملاء.

• عنوان URL الأساسي: HTTPS://api.qwenapikey.com/v1
• رأس المصادقة: Authorization: Bearer

يتم إنشاء مفتاح API عند التسجيل. احتفظ به بأمان. يمكنك تدويره في أي وقت من لوحة التحكم الخاصة بك.

الطلب الأول

أرسل طلب POST إلى /v1/chat/completions للحصول على استجابة. استخدم معرف النموذج "uncensored".

إليك مثال باستخدام cURL:

• الأمر: 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 يحتوي على النص المُولّد.

تكامل واجهة برمجة تطبيقات 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

استخدم حزمة Node 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. تُرجع واجهة برمجة التطبيقات أحداث الإرسال من الخادم (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); }

تحقق من القطعة الأخيرة للحصول على إحصائيات الاستخدام.

حدود، أخطاء، والسياق

التعامل مع أخطاء 401 للمفاتيح غير الصالحة، و402 لعدم كفاية الرصيد، و429 لحدود معدل الطلبات. نافذة السياق هي 100,000 رمز. الحد الأقصى للإخراج هو 16,000 رمز. حد الطلبات هو 300 في الدقيقة.

راقب استخدامك عبر لوحة التحكم. لا يتم خصم الرصيد مقابل الأخطاء أثناء المعالجة. الرفضات لسياسة المحتوى مجانية أيضاً.

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"}]
  }'

Python

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)