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

إعداد البيئة والتثبيت

ابدأ بتثبيت مكتبة العميل الرسمية للغتك. تخدم خدمتنا وراء الواجهة /v1 المسار، بحيث تحتاج فقط إلى تحديث عنوان URL الأساسي ومفتاح API. عنوان URL الأساسي في هذا الموقع هو HTTPS://api.claudeprecio.com/v1. يعتمد المصادقة على مفتاح نشط واحد فقط لكل حساب. يمكنك إنشاء هذا المفتاح فورًا عبر Google أو البريد الإلكتروني في صفحة "Get API key". لا يلزم رقم هاتف. يظهر المفتاح مرة واحدة، لذا انسخه بأمان.

إجراء أول طلب باستخدام Python

أرسل طلب إكمال باستخدام حزمة تطوير البرامج (SDK) القياسية لـ Python. وجه العميل إلى عنوان URL الأساسي الخاص بنا واضبط النموذج على "uncensored". يعمل هذا النموذج مفتوح الوزن على خوادمنا الخاصة وهو مُضبط للإجابة دون رفض المحتوى. يمكنك تمرير معلمات مثل temperature أو top_p تماماً كما تفعل مع أي خدمة متوافقة مع OpenAI. يظل هيكل الطلب مطابقاً للتنسيق القياسي.

Copyfrom openai import OpenAI

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

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

تتبع استخدام الاستجابات التدفقية

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

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)

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

المعلمات: درجة الحرارة وtop_p والبذلة

تحكم في الإبداع وقابلية الاستنساخ باستخدام معاملات التوليد القياسية. الـ temperature القيمة تضبط العشوائية، مع إنتاج القيم الأقل مخرجات أكثر حتمية. استخدم top_p لتقييد أخذ العينات على الكتلة الاحتمالية الأعلى. تعيين seed لضمان حالة عشوائية ثابتة للحصول على نتائج قابلة للتكرار عبر مكالمات متعددة. تعمل هذه المعلمات بنفس الطريقة القياسية لـ OpenAI. اضبطها بناءً على حالة الاستخدام الخاصة بك، سواء كانت برمجة أو كتابة إبداعية.

Copyimport OpenAI from "openai";

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

ادمج هذه الإعدادات للحصول على تحكم دقيق. على سبيل المثال، تضمن درجة الحرارة المنخفضة مع بذرة (Seed) ثابتة مخرجات متسقة للاختبار. يدعم النموذج جميع المعاملات القياسية مثل stop sequences و presence_penalty. جرب للوصول إلى التوازن المناسب لمشروعك المحدد.

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

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

Copycurl https://api.claudeprecio.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total cost for 10 million input tokens and 3 million output tokens"}]
  }'

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

حدود، أخطاء، ونافذة السياق

يدعم نافذة السياق 100,000 رمز للنص البرمجي والإكمال المجمع. الحد الأقصى للإخراج لكل طلب هو 16,000 رمز. إذا max_tokens غير مضبوط، فإن الحد الافتراضي هو 2,048. يُسمح لك بـ 300 طلب في الدقيقة لكل مفتاح. يتم تقييد التزامن بـ 8 طلبات متزامنة لكل مفتاح. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. يتم التعامل مع أخطاء مثل 401 و402 و429 عبر رموز حالة HTTP القياسية. يتم حساب استخدام الرموز بدقة، والأخطاء مجانية.