البداية السريعة

نحو دقيقتين، بافتراض أن Python أو Node مثبَّت لديك بالفعل.

1. احصل على مفتاح

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

أبقِه بعيدًا عن كود العميل وعن git. كل ما يستطيع قراءة المفتاح يستطيع إنفاق رصيدك.

2. وجّه عميلك إلى البوابة

ريداكترون يتحدث واجهة chat-completions الخاصة بـ OpenAI. إن كان كودك يتحدث إلى OpenAI بالفعل، فالتغيير الوحيد هو الـ base URL والمفتاح.

# Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.redactron.ai/v1",
    api_key="<REDACTRON_API_KEY>",
)

// Node
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.redactron.ai/v1",
  apiKey: process.env.REDACTRON_API_KEY,
});

3. أرسل طلبًا

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Say hello in three words."}],
)
print(response.choices[0].message.content)

أو باستخدام curl:

curl https://api.redactron.ai/v1/chat/completions \
  -H "Authorization: Bearer $REDACTRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Hello"}]}'

4. البثّ

مرّر stream=True واقرأ الأجزاء فور وصولها. البثّ الذي يفشل في منتصفه يُبلَّغ عنه كطلب فاشل لا كطلب ناجح قصير، فلا تضطر أبدًا إلى تخمين ما إذا كان النص الذي وصلك كاملًا.

stream = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Count to five."}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

النماذج

استخدم اسم النموذج كما هو عند المزوّد — gpt-5.6-sol — لا اسمًا بديلًا من ريداكترون. فهرس لوحة التحكم هو القائمة المرجعية لما يمكنك استدعاؤه وكم يكلّف؛ وصفحة الأسعار تعرض الأسعار الحالية.

الأخطاء التي ستقابلها فعلًا

ماذا يكلّفك الطلب

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

تدوير مفتاح

أنشئ المفتاح الجديد أولًا، وانشره، ثم أبطل القديم — بهذا الترتيب، حتى لا يعمل شيء ولو للحظة بلا بيانات اعتماد صالحة.

الحصول على المساعدة

[email protected]. أرفق request_id من جسم الخطأ؛ فهو أسرع طريق لنا لمعرفة ما حدث لطلب بعينه.