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

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

توصيل إلى https://api.tokenllm.cc/v1 باستخدام مفتاح API الفريد الخاص بك. يعمل عنوان URL الأساسي هذا مع أي مكتبة OpenAI SDK قياسية عن طريق تعيين base_url المتغير. تتلقى مفتاحاً نشطاً واحداً لكل حساب؛ يولد مفتاحاً جديداً يستبدل المفتاح السابق. تعتمد المصادقة على Authorization: Bearer <key> الرأس. لا نتتبع طلباتك للتدريب، ويمكنك التسجيل عبر Google أو البريد الإلكتروني دون رقم هاتف. الأخطاء والرفض تستهلك صفر رموز، لذا تدفع فقط مقابل الاستدلال الفعلي.

نقطة نهاية إكمال الدردشة

أرسل نصًا إلى POST /v1/chat/completions لتوليد الاستجابات. يتعامل هذا الطرف النهائي مع سير العمل النص-إلى-نص باستخدام نموذجنا غير الخاضع للرقابة. لا تحتاج إلى التضميمات أو توليد الصور لمهام الدردشة القياسية. معرف النموذج هو دائمًا "uncensored". تتم معالجة الطلبات على خوادمنا الخاصة، مما يضمن عدم تصفية مخرجاتك بواسطة مزود طرف ثالث. حافظ على حمولتك أقل من 8 ميجابايت لتجنب مشاكل التقطيع.

المعاملات المطلوبة والاختيارية

تضمين messages مصفوفة مع سجل محادثتك. اضبط model إلى "uncensored" لضمان التوجيه الصحيح. يمكنك تعديل temperature للإبداع أو top_p للتنوع. استخدم max_tokens حصر المخرجات عند 16,000 رمز مميز، أو الافتراضي إلى 2,048. تدعم نافذة السياق 100,000 رمز مميز إجمالًا للسياق والإكمال. المعاملات الاختيارية مثل seed و stop تمنحك تحكماً دقيقاً في عملية التوليد.

استجابات البث عبر SSE

فعّل البث عن طريق تعيين stream: true في طلبك. يعيد الواجهة البرمجية أحداث الإرسال من الخادم (SSE) لتسليم الرموات في الوقت الفعلي. تحتوي كل شريحة على نص جزئي، وتشمل الشريحة الأخيرة إحصائيات إجمالي استخدام الرموات. يقلل هذا النهج من زمن الانتظار المُدرَك للاستجابات الطويلة. يمكنك معالجة الرموات أثناء وصولها، وهو أمر مثالي لواجهات الدردشة. يعمل التدفق مع جميع المعاملات القياسية.

استدعاء الوظائف ووضع JSON

عرّف الأدوات في tools المعامل لقدرات استدعاء الوظائف. يمكن للنموذج إخراج JSON هيكلي عندما تضبط response_format إلى {"type": "json_object"}. هذا يضمن تحليلًا موثوقًا للتطبيقات اللاحقة. يمكنك تحديد tool_choice لإجبار أو السماح بالاختيار التلقائي. تعمل هذه الميزات ضمن نموذج واحد غير خاضع للرقابة، لذا لا تحتاج إلى مزود إخراج منظم منفصل.

معالجة الأخطاء واستخدام التوكن

التعامل مع HTTP 401 للمفاتيح غير الصالحة و429 لحدود معدل الطلبات. أنت مقيد بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. إذا حصلت على 402، فإن رصيدك المدفوع مسبقاً قد استُنفد. لا يتم خصم الرموز للرفضات بسبب فلاتر المحتوى (مثل المحتوى الجنسي للقاصرين). لا تنتهي صلاحية الرصيد في API، لذا يمكنك الشحن في أي وقت. تحقق دائماً من جسم الاستجابة للحصول على رسائل خطأ مفصلة.

cURL

Copycurl https://api.tokenllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current price of one llm token"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)