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

ثبّت حزمة SDK الرسمية من OpenAI

ابدأ بتثبيت المكتبة القياسية التي يستخدمها معظم المطورين. تتولى هذه الحزمة بروتوكول HTTP نيابةً عنك.

• Python: pip install openai
• Node.js: npm install openai

بمجرد التثبيت، أنت جاهز لتفاصيل الاتصال.

قم بتكوين عنوان URL الأساسي ومفتاح API الخاص بك

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

• URL الأساسي: https://api.preciotokensclaude.com/v1
• معرف النموذج: uncensored

يظهر مفتاح واجهة برمجة التطبيقات الخاصة بك فوراً بعد التسجيل عبر Google أو البريد الإلكتروني.

أجرِ أول طلب إكمال للدردشة

أرسل مطالبة نصية بسيطة لاختبار التكامل. يستجيب النموذج بإخراج نصي فقط.

يستخدم هذا المثال cURL للتحقق من الاتصال.

Copycurl https://api.preciotokensclaude.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Count the tokens in this 500 word essay"}]
  }'

يحتوي الرد على النص المُولّد وإحصائيات استخدام الرموز. تشير الأخطاء مثل 401 أو 402 إلى مشكلات في المصادقة أو الرصيد.

تمكين التدفق لاستجابات فورية

استخدم أحداث الإرسال الخادم لتأخير أقل. تظهر الرموز أثناء توليدها.

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)

يُعد البث المباشر مثاليًا لواجهات الدردشة. يتضمن كل شق بيانات الاستخدام في الحمولة النهائية.

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

عرّف الأدوات لاستخراج البيانات المهيكلة. اضبط response_format إلى {"type": "json_object"} لـ JSON الصارم.

Copyimport OpenAI from "openai";

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

يعمل كل من البث واستدعاء الوظائف معًا. يمكنك تحليل المخرجات المنظمة مباشرة في منطق تطبيقك.

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

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

حدود معدل الطلبات هي 300 طلب في الدقيقة. يعني خطأ 429 أنك وصلت إلى الحد الأقصى. تحقق من رصيد رصيدك قبل الأحمال الثقيلة.

Python

Copyfrom openai import OpenAI

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