توثيق واجهة برمجة التطبيقات

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

ابدأ بإنشاء المفتاح الخاص بك على لوحة التحكم. عنوان URL الأساسي الخاص بنا هو HTTPS://api.aivenice.cc/v1. مرر مفتاحك في رأس المصادقة. مفتاح نشط واحد لكل حساب يحل القديم تلقائياً.

مثال على الطلب الأول

أرسل إكمال محادثة بسيط لاختبار الاتصال. معرف النموذج هو "uncensored". يتعامل مع النص المدخل والمخرج بكفاءة. يمكنك ضبط معلمات مثل درجة الحرارة للإبداع.

Copyfrom openai import OpenAI

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

استخدم مكتبة Node SDK الرسمية للتكامل السهل. اضبط عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا. مرر مفتاح API الخاص بك في كائن التكوين. تعمل هذه الطريقة مع معظم المكتبات المتوافقة مع OpenAI.

Copyimport OpenAI from "openai";

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

تعامل مع الاستجابات مباشرة في بيئة JavaScript الخاصة بك. يتطابق الهيكل مع تنسيقات OpenAI القياسية للتعرف عليها.

استجابات البث

فعّل التدفق عن طريق تعيين stream إلى true. تتلقى الرموز بمجرد توليدها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين. يتضمن الجزء الأخير تفاصيل استخدام الرموز الإجمالي.

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)

تحليل أحداث SSE لتحديث واجهة المستخدم في الوقت الفعلي. هذا مثالي لواجهات الدردشة التي تتطلب ملاحظات فورية.

المعاملات والحدود

عدّل درجة الحرارة وtop_p والبذرة للتحكم. الحد الأقصى للمخرجات هو 16,000 رمز. نافذة السياق هي 100,000 رمز. حد معدل الطلب هو 300 طلب في الدقيقة. الحد الأقصى لحجم الجسم هو 8 ميجابايت.

هذه الحدود تضمن أداءً مستقراً. يؤدي تجاوز حدود معدل الطلبات إلى إرجاع خطأ 429. زد من التوازي إذا لزم الأمر.

الأخطاء ونافذة السياق

التعامل مع أخطاء 401 للمفاتيح غير الصالحة. استخدم 402 عندما يكون الرصيد منخفضاً. يشير 429 إلى تجاوز حد معدل الطلب. الأخطاء والرفضات مجانية. رصيدك المدفوع مسبقاً لا ينتهي. تحسب نافذة السياق رموز الإدراك والإكمال معاً.

راقب الاستخدام عبر الشريحة النهائية في التدفق. يساعدك ذلك على البقاء ضمن الميزانية. لا توجد رسوم خفية.

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'