البدء السريع لمستخدمي Claude Code

المصادقة

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

نقطة نهاية إكمال المحادثات

أرسل موجّهات البرمجة الخاصة بك إلى نقطة النهاية القياسية لإكمال الدردشة. عنوان URL الأساسي لجميع الطلبات هو https://api.claudecodeapikey.com/v1. استخدم معرف النموذج uncensored للوصول إلى نموذج اللغة الكبير الخاص بنا. هذا النموذج مضبوط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعله مثالياً لتوليد الكود دون حواجز غير ضرورية. تدعم نقطة النهاية كل من الاستجابات القياسية والمتدفقة. فيما يلي مثال لطلب أساسي باستخدام curl.

Copycurl https://api.claudecodeapikey.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."}]
  }'

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

مكتبة Python SDK

للمطورين الذين يستخدمون Python، يمكنك دمج واجهة برمجة التطبيقات الخاصة بنا باستخدام SDK الرسمي من OpenAI. ببساطة، وجه العميل إلى عنوان URL الأساسي الخاص بنا وقم بتوفير مفتاح API الخاص بك. يعمل معرف النموذج uncensored تماماً مثل النماذج الأخرى المتوافقة مع OpenAI في SDK. يمكنك استدعاء طريقة الإكمال ومعالجة الاستجابة ككائن نصي قياسي. هذا النهج مثالي للمعالجة الدفعية أو الدمج في سكريبتات الأتمتة الأكبر.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudecodeapikey.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 يتولى عملية تسلسل JSON نيابةً عنك. كل ما عليك ضمانه هو أن متغير base_url يشير إلى الوكيل الخاص بنا. يحتوي كائن الاستجابة على النص المُولّد، والذي يمكنك بعد ذلك كتابته في ملفاتك أو إعادته إلى سياق المحادثة.

مكتبة Node SDK

يمكن لمطوري Node.js استخدام حزمة npm الخاصة بـ OpenAI للتفاعل مع الخدمة الوسيطة الخاصة بنا. قم بتكوين العميل بعنوان URL الأساسي المخصص ومفتاح API الخاص بك. نمط الاستخدام يعكس التنفيذ في Python: إنشاء عميل، استدعاء نقطة نهاية إكمال المحادثات، ومعالجة النتيجة. هذا مفيد لتوليد الكود من جانب الخادم أو مساعدي البرمجة في الوقت الفعلي.

Copyimport OpenAI from "openai";

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

تدير مكتبة Node اتصالات HTTP بكفاءة. تأكد من أنك تستخدم إصداراً من المكتبة يدعم عناوين URL الأساسية المخصصة. يظل هيكل الاستجابة متسقاً مع معيار OpenAI، مما يسهل التبديل بين مزودي OpenAI المتوافقين المختلفين إذا لزم الأمر.

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

للحصول على مساعدة برمجية في الوقت الفعلي، فعّل البث المتدفق عن طريق تعيين 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)

عالج أحداث التدفق في الكود الخاص بك لتراكم الاستجابة النهائية. لا يستهلك البث المتدفق رموزاً أكثر من طلب غير متدفق؛ فهو يغير فقط كيفية تسليم البيانات. هذا مفيد بشكل خاص لكتل الكود الطويلة حيث تريد عرض التقدم فوراً.

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

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