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

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. يجب أن تدرجه في Authorization رأس الصفحة كرمز حامل (Bearer token). استخدم عنوان URL الأساسي https://api.textspolitical.com/v1 لجميع نقاط النهاية. يعمل هذا الرابط مع أدوات SDK القياسية الخاصة بـ OpenAI وأي عميل متوافق. يمنحك المفتاح الوصول إلى النموذج غير الخاضع للرقابة دون رسوم اشتراك.

إرسال أول إكمال دردشة لك

أرسل طلب POST إلى /v1/chat/completions مع طلبك. معرف النموذج هو uncensored. يستجيب بالنص دون تصفية المحتوى القانوني للبالغين. هذا تنسيق الاستجابة المباشرة مثالي لتوليد رسائل سياسية بالجملة. استخدم المثال التالي للتحقق من اتصالك.

Copycurl https://api.textspolitical.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three benefits of digital surveys for campaign outreach"}]
  }'

باستخدام واجهات برمجة التطبيقات (SDKs) لـ Python و Node

ثبّت الحزمة الرسمية من OpenAI لتبسيط التكامل. مرر عنوان URL الأساسي ومفتاح API الخاص بك أثناء التهيئة. تتعامل حزمة SDK الخاصة بـ Python مع تسلسل JSON تلقائيًا. توفر حزمة Node وظائف مماثلة لبيئات JavaScript. تدعم كلتا الأداتين المعلمات المطلوبة مثل درجة الحرارة و top_p.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

فعّل البث عن طريق تعيين stream: true. تتلقى أحداث Server-Sent (SSE) بينما يتم توليد الرموز. هذا يقلل من زمن الانتظار المُدرَك للنصوص السياسية الطويلة. تظهر تفاصيل استخدام الرموز في الشريحة الأخيرة. هذه الطريقة ضرورية لواجهات الدردشة في الوقت الفعلي أو توليد النص المباشر.

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 تعيين إلى json_object لبيانات مُهيّأة. يسمح استدعاء الوظائف للنموذج بإخراج الأدوات المحددة. هذا مفيد لبيانات المسح أو الرسائل السياسية المُصنّفة. يمكنك أيضًا ضبط tool_choice لإجبار سلوكيات محددة. تأكد من مطابقة مخططك لتنسيق الإخراج المتوقع.

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

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