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

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

ابدأ بتوجيه عميلك إلى عنوان URL الأساسي الخاص بنا وإرسال مفتاحك في رأس المصادقة. نستخدم نموذج ائتمان مسبق بسيط يُحسب بناءً على استخدام الرموز الفعلية، لذا فإن الأخطاء والرفضات مجانية. يمكنك إنشاء مفتاح فورًا عبر Google أو البريد الإلكتروني دون الحاجة إلى رقم هاتف، ويظهر المفتاح مباشرة بعد التسجيل.

الطلب الأول

أرسل طلب POST إلى نقطة نهاية إكمال الدردشة للحصول على استجابة نصية من النموذج uncensored. استخدم معرف النموذج 'uncensored' للتأكد من أنك تصل إلى خادمنا المفتوح الوزن المحدد وليس وكيلًا عامًا. يقبل النظام معلمات قياسية مثل درجة الحرارة وtop_p للتحكم في العشوائية.

Copyfrom openai import OpenAI

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

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

فعّل التدفق عن طريق تعيين معلمة 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)

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

استخدم معلمة response_format لفرض إخراج JSON صارم لتحليل موثوق في تطبيقاتك. يمكنك أيضاً تعريف الأدوات و tool_choice للسماح للنموذج بالقرار متى يجب استدعاء وظائف محددة. هذا يعمل تماماً مثل واجهة مكتبة SDK القياسية لـ OpenAI.

Copyimport OpenAI from "openai";

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

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

مفتاح API الخاص بك محدود بـ 300 طلب في الدقيقة ويسمح بثمانية طلبات متزامنة فقط. حجم أقصى لواجهة الطلب هو 8 ميجابايت، ويمكنك طلب ما يصل إلى 16,000 رمز لكل إكمال. إذا تجاوزت هذه الحدود، يعيد الخادم رمز حالة 429.

الأخطاء الشائعة والسياق

يشير خطأ 401 إلى أن مفتاحك غير صالح أو منتهي الصلاحية، بينما يشير خطأ 402 إلى استنفاد رصيدك المدفوع مسبقاً. يمكنك إضافة رصيد باستخدام USDT (TRC20) أو USDC (Base) بدءاً من $20 للمتابعة في استخدام الخدمة. نافذة السياق هي 100,000 رمز للطلب والإكمال معاً.

cURL

Copycurl https://api.keyapiclaude.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 3 steps to validate an API key"}]
  }'