تكلفة رموز كلاود: وثائق متوافقة مع OpenAI

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

ابدأ بتوجيه حزمة SDK الخاصة بك إلى عنوان URL الأساسي الخاص بنا وتمرير مفتاح API الخاص بك في رأس المصادقة. نطلب مصادقة بسيطة تعتمد على الرؤوس، لذا لا تحتاج إلى تدفقات OAuth معقدة أو منطق تهيئة محدد لحزمة SDK. أنشئ حسابًا عبر Google أو البريد الإلكتروني، ثم احصل على مفتاحك فورًا من لوحة التحكم. يمنحك هذا المفتاح الوصول إلى النموذج غير المقيد الوحيد والمحدد باسم 'uncensored'. يمكنك تدوير المفاتيح إذا لزم الأمر، ولكن يوجد مفتاح نشط واحد فقط لكل حساب في أي وقت. تأكد من تكوين مكتبة العميل الخاصة بك لإرسال رمز Bearer بشكل صحيح قبل إجراء طلبك الأول.

هيكل نقطة نهاية إكمال الدردشة

أرسل طلبات POST إلى /v1/chat/completions مع مصفوفة رسائل تحتوي على مطالبتك وتعليمات النظام. يقبل الطرف حمولات JSON متوافقة مع OpenAI القياسية، مما يتيح لك تبديل خدمتنا في Cursor أو Windsurf أو البرامج النصية المخصصة دون إعادة كتابة الشيفرة. حدد النموذج على أنه 'uncensored' لضمان الحصول على مخرجات نموذج الذكاء الاصطناعي غير المقيد المحدد لدينا. يمكنك التحكم في الإبداع عبر درجة الحرارة و top_p، أو فرض النتائج الحتمية عن طريق تعيين درجة الحرارة إلى 0. تتم معالجة الطلبات على الفور، ويتم احتساب الفوترة فقط مقابل استخدام الرموز الفعلي. لا تستهلك الأخطاء والرفضات رصيدك المدفوع مسبقًا.

الاستجابات التدفقية واستخدام الرموز

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

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

استخدم معلمة tools لتعريف مخططات الوظائف لاستدعاء الوظائف، أو اضبط response_format على json_object للحصول على مخرجات JSON صارمة. يدعم النموذج استخراج البيانات المهيكلة والتنفيذ الديناميكي للأدوات ضمن نافذة السياق نفسها. يمكنك تعريف أدوات متعددة في طلب واحد، وسيعيد النموذج استدعاءات الأدوات أو استجابات نصية مباشرة حسب الحاجة. يجعل هذا المرونة واجهة برمجة التطبيقات مناسبة لبناء الوكلاء أو أتمتة عمليات سير العمل. تأكد من أن تعريفات وظائفك تتبع تنسيق OpenAI لضمان التوافق مع العملاء القياسيين.

قواعد حدود المعدلات والتزامن

يتيح كل مفتاح API 300 طلب في الدقيقة وحتى 8 طلبات متزامنة في وقت واحد. حجم جسم الطلب الأقصى هو 8 ميجابايت، مما يحد من كمية البيانات التي يمكنك إرسالها في طلب واحد. إذا تجاوزت هذه الحدود، ستتلقى رمز الحالة 429 الذي يشير إلى أنك وصلت إلى حد معدل الطلب. يمكنك مراقبة استخدامك عبر استجابة التدفق أو نقطة النهاية /v1/models. تضمن هذه الحدود أداءً مستقراً لجميع المستخدمين. خطط لمعالجة الدفعات وفقاً لذلك لتجنب الاختناق أثناء أوقات الذروة.

معالجة الأخطاء والاسترداد

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

cURL

Copycurl https://api.claudetokenpricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate the cost for 100k tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)