دليل البدء السريع لواجهات برمجة تطبيقات الوكلاء

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

The Proxy API يعيش في HTTPS://api.proxyclaude.com/v1. مرر مفتاحك في Authorization رأس. يحصل كل حساب جديد على مفتاح فوراً بعد التسجيل باستخدام Google أو البريد الإلكتروني. لا يلزم رقم هاتف. يتطابق تنسيق الرأس تماماً مع واجهات برمجة التطبيقات (SDKs) الرسمية.

• رأس: Authorization: Bearer YOUR_API_KEY
• URL الأساسي: https://api.proxyclaude.com/v1

الطلب الأول

أرسل إكمال نص بسيط للتحقق من الاتصال. استخدم معرف النموذج uncensored لنموذج اللغة الكبيرة الافتراضي. تقبل نقطة المعلمات معلمات الدردشة القياسية. يمكنك ضبط درجة الحرارة أو ضبط البذرة لإعادة الإنتاجية. تُرجع الأخطاء أكواد HTTP القياسية.

Copycurl https://api.proxyclaude.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all python packages installed in the current virtual environment"}]
  }'

استخدام مكتبة Python

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

Copyfrom openai import OpenAI

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

تكامل Node SDK

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

Copyimport OpenAI from "openai";

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

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

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

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)

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

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