API واحد: دليل البدء السريع

عنوان URL والمصادقة

ابدأ بتوجيه عميلك إلى نقطة النهاية المخصصة لدينا. يستخدم هذا الـ openai compatible api رؤوس المصادقة القياسية، لذا لا تحتاج إلا إلى تغيير قيمتين في تكوينك.

عنوان URL الأساسي هو https://api.onekeyllmapi.com/v1. أنشئ مفتاح API الفريد الخاص بك في صفحة تسجيل الدخول. لا حاجة لبطاقة ائتمان للبدء، ويظهر المفتاح فوراً بعد التسجيل. احفظ هذا المفتاح بأمان؛ فهو يصادق على جميع الطلبات الموجهة إلى الخدمة.

الإكمال الأساسي

أرسل موجّه نصي بسيط للحصول على استجابة مباشرة. هذا هو جوهر عرض الـ ai api for developers لدينا. يعيد النموذج النص بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعله مثالياً للمهام الإبداعية أو غير المقيدة.

• معرف النموذج: uncensored
• نقطة النهاية: POST /v1/chat/completions
• السياق: 100,000 رمز

قم بإرسال طلبك الأول باستخدام هذا المثال:

Copycurl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

تكامل SDK Python

استخدم مكتبة Python الرسمية لـ OpenAI للتفاعل مع خدمتنا. التغييرات الوحيدة المطلوبة هي base_url و api_key. هذا يضمن عمل منطقك الحالي دون تعديل.

• التثبيت عبر pip install openai
• تعيين متغيرات البيئة أو تمريرها مباشرة في تهيئة العميل
• استدعاء chat.completions.create() كما هو معتاد

قم بتكوين العميل كما يلي:

Copyfrom openai import OpenAI

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

استخدام SDK Node.js

قم بالدمج مع مشاريع JavaScript أو TypeScript باستخدام حزمة OpenAI Node القياسية. وجه العميل إلى عنوان URL الخاص بنا وقم بتوفير مفتاحك. يحافظ هذا النهج على التوافق مع أي بنية عميل متوافقة مع OpenAI.

• التثبيت عبر npm install openai
• تهيئة مع عنوان URL الأساسي المخصص
• استخدم أنماط async/await القياسية

مثال على التهيئة:

Copyimport OpenAI from "openai";

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

استجابات البث المتدفق

استلم الاستجابات رمزاً تلو الآخر لتقليل زمن الاستجابة المُدرَك. يدعم الـ streaming api لدينا أحداث الإرسال الخادم (SSE)، مما يتيح لك عرض المخرجات أثناء توليدها. هذا مفيد لواجهات الدردشة أو التطبيقات في الوقت الفعلي.

• تعيين 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)

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

فهم القيود لبناء تكاملات قوية. تدعم الواجهة البرمجية نافذة سياق 100k context api، مما يتيح معالجة المستندات الطويلة أو المحادثات. يتم تقييد حجم جسم الطلب بـ 8 ميجابايت.

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