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

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

يتوافق الـ API الخاص بنا مع معيار توافق OpenAI، مما يعني أنك على الأرجح تملك مكتبات العملاء اللازمة للاتصال. تتطلب جميع الطلبات مفتاح API صالح يتم تمريره في رأس Authorization. عنوان URL الأساسي لجميع نقاط النهاية هو https://api.claudeapicost.com/v1. يمكنك إنشاء مفتاحك في صفحة "الحصول على مفتاح API" باستخدام البريد الإلكتروني وكلمة المرور فقط. لا يلزم بطاقة ائتمان للبدء، وتتلقى رصيدًا تجريجيًا بقيمة $0.50 صالح لمدة 7 أيام. احفظ مفتاحك بأمان، حيث يمكن تجديده في أي وقت لإلغاء الوصول.

الطلب الأول

أرسل طلب إكمال محادثة قياسي لبدء توليد النص. معرف النموذج هو دائماً uncensored. تدعم نقطة النهاية كل من الردود المتدفقة وغير المتدفقة. فيما يلي مثال أساسي باستخدام cURL لإرسال موجّه بسيط واستقبال رد نصي.

استخدم هذا الهيكل للتحقق من الاتصال قبل التكامل في تطبيقك. يتضمن الرد النص المُولّد في مصفوفة choices.

• نقطة النهاية: POST /v1/chat/completions
• النموذج: uncensored
• الرد: كائن JSON يحتوي على محتوى نصي

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

تكامل SDK لـ Python

لمطوري Python، تعمل الحزمة الرسمية openai مباشرة مع خدمتنا عن طريق تجاوز عنوان URL الأساسي. يتيح لك هذا النهج استخدام طرق SDK المألوفة مثل client.chat.completions.create(). تأكد من تعيين المعلمة base_url إلى نقطة النهاية الخاصة بنا وتقديم مفتاح API الخاص بك. هذه الطريقة مثالية لخدمات الخلفية أو البرامج النصية حيث تحتاج إلى مخرجات نصية منظمة دون إدارة طلبات HTTP الخام.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudeapicost.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 لـ Node.js

يمكن لمطوري Node.js تحقيق نفس التوافق عن طريق تعديل baseUrl في تكوين SDK. يتيح لك ذلك دمج نموذجنا بدون رقابة في تطبيقات Node.js الحالية مع الحد الأدنى من تغييرات الكود. يتعامل SDK مع الترميز وتنسيق الطلبات، لذا يمكنك التركيز على هندسة الموجّه. تذكر تمرير معرف النموذج uncensored في طلبات الإكمال.

Copyimport OpenAI from "openai";

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

الردود المتدفقة عبر SSE

بالنسبة للتطبيقات التي تتطلب توليد نص في الوقت الفعلي، ندعم أحداث الإرسال من الخادم (SSE). يقلل البث المتدفق من زمن الاستجابة المدرك من خلال تسليم الرموز بمجرد توليدها. اضبط المعلمة 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)

حدود المعدل والقيود

تفرض خدمتنا حدودًا صارمة لضمان الاستقرار. يُسمح لك بـ 300 طلب في الدقيقة لكل مفتاح API. الحد الأقصى لحجم جسم الطلب هو 8 MB. إذا كان مفتاحك غير صالح أو منتهي الصلاحية، ستتلقى خطأ 401. إذا استنفد رصيدك المسبق للدفع، سترى خطأ 402 يتطلب شحن الرصيد. يشير رمز الحالة 429 إلى أنك تجاوزت حدّ المعدل. تدعم نافذة السياق 100,000 رمز لكل من الموجّه والإكمال معًا. الرصيد مسبق الدفع ولا ينتهي، مع مكافآت متاحة للشحنات الأكبر.