API المطوّرين

قوة ChatQT، بين أيدي المطوّرين.

عشرات نماذج الذكاء الاصطناعي من نقطة نهاية واحدة — متوافقة مع OpenAI SDK، بدون VPN من إيران. مفتاح API والتوثيق وإحصاءات الاستهلاك وشحن المحفظة في وحدة تحكّم المطوّرين. للطرفية: دليل Claude CLI؛ للأتمتة: دليل n8n.

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.chatqt.com/api/v1",
    api_key="<CHATQT_API_KEY>",
)

completion = client.chat.completions.create(
    model="openai/gpt-4.1",
    messages=[
        {"role": "user", "content": "ما معنى الحياة؟"},
    ],
)

print(completion.choices[0].message.content)

وحدة تحكّم المطوّرين

كل شيء في لوحة واحدة.

في console.chatqt.com تنشئ مفتاح API، وتختار نموذجًا، وتقرأ التوثيق، وتراقب الاستهلاك، وتشحن المحفظة — دون الحاجة إلى VPN من إيران.

مفاتيح API

مفاتيح منفصلة لبيئتي التطوير والإنتاج؛ عرض آمن (مُقنّع) وإدارة من جدول واحد.

النماذج

قائمة بنماذج ChatGPT وClaude وGemini وGrok وعشرات غيرها، لكلٍّ معرّف فريد لطلبات API.

توثيق تفاعلي

بدء سريع، Streaming، Tool Calls، الوسائط المتعددة، المعاملات وإدارة الأخطاء — نفس محتوى وحدة التحكم.

إحصاءات الاستخدام

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

المحفظة

رصيد بالدولار، وشحن إلكتروني عبر البوابة البنكية، وفوترة حسب الاستخدام الفعلي.

بدء سريع

البدء مع ChatQT

ChatQT واجهة موحّدة للوصول إلى عشرات نماذج الذكاء الاصطناعي من نقطة نهاية واحدة. ببضعة أسطر برمجية ومفتاح API من وحدة التحكم، يمكنك استخدام أي إطار عمل أو SDK تريده.

  1. 1

    التسجيل في وحدة التحكم

    أنشئ حسابًا واشحن محفظتك.

  2. 2

    إنشاء مفتاح API

    أنشئ مفتاحًا جديدًا من قسم «مفاتيح API».

  3. 3

    أول طلب

    اختبر باستخدام OpenAI SDK أو REST.

استخدام OpenAI SDK

متوافق مع مكتبة OpenAI الرسمية — فقط غيّر base_url و api_key :

Python
pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://api.chatqt.com/api/v1",
    api_key="YOUR_CHATQT_API_KEY",
)

completion = client.chat.completions.create(
    model="openai/gpt-4.1",
    messages=[
        {"role": "user", "content": "ما معنى الحياة؟"},
    ],
)

print(completion.choices[0].message.content)

استخدام API مباشرة

بأي لغة عبر HTTP — مثال بلغة Python و requests:

Python
import requests

url = "https://api.chatqt.com/api/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_CHATQT_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "مرحبًا!"}],
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])

المصادقة

العنوان الأساسي ومفتاح API

Base URLhttps://api.chatqt.com/api/v1
الترويسةAuthorization: Bearer YOUR_CHATQT_API_KEY
الصيغةJSON · متوافق مع OpenAI Chat Completions

المفاتيح ذات البادئة sk-or-v1- تظهر في وحدة التحكم. لا تُدرج المفتاح أبدًا في مستودع عام؛ استخدم متغيّر بيئة.

الإمكانيات

واجهة واحدة، عشرات النماذج.

من المحادثة والبث إلى الصور والفيديو والصوت وTool Calls — كلها من بوابة واحدة. تفاصيل كل نقطة نهاية في وحدة التحكم ← التوثيق.

chat/completions

المحادثة

Chat Completions متعددة الخطوات، سجل الرسائل، ودعم system / user / assistant.

Streaming

ردود رمزًا برمز باستخدام stream: true — مناسب لواجهات الدردشة.

Tool Calls

استدعاء الدوال والأدوات الخارجية بواجهة موحّدة بين النماذج.

الوسائط المتعددة

إدخال الصور والصوت والملفات في الرسائل — حسب النموذج المختار.

المعاملات

temperature وmax_tokens وtop_p وإعدادات النموذج الأخرى في جسم الطلب.

Embeddings وأكثر

تضمين النص، TTS، STT وتوليد الصور/الفيديو للنماذج المدعومة.

Streaming

الردود المتدفقة

لعرض الرد تدريجيًا في الواجهة، فعّل المعامل stream ؛ تدعم حزمة OpenAI SDK الرسمية البث.

Python
stream = client.chat.completions.create(
    model="openai/gpt-4.1",
    messages=[{"role": "user", "content": "اكتب قصة قصيرة"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Tool Calls

استدعاء الأدوات والدوال

يتيح Tool Calling للنموذج اقتراح أدوات خارجية. لا ينفّذ النموذج الأداة مباشرة — أنت تستدعي الدالة وتُعيد النتيجة إلى المحادثة. يوفّر ChatQT واجهة موحّدة لجميع النماذج المدعومة.

الخطوة 1: طلب مع tools
الخطوة 2: تنفيذ الأداة
الخطوة 3: إرسال النتيجة
JSON
{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {"role": "user", "content": "ما عناوين بعض كتب جيمس جويس؟"}
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "search_books",
        "description": "البحث عن الكتب حسب المؤلف",
        "parameters": {
          "type": "object",
          "properties": {
            "author": {"type": "string"}
          }
        }
      }
    }
  ]
}

النماذج

معرّف النموذج (Model ID)

في الحقل model استخدم المعرّف الفريد من وحدة التحكم — عادةً بالشكل provider/model-name (مثلاً openai/gpt-4.1، anthropic/claude-sonnet-4.6). القائمة الكاملة في وحدة التحكم ← النماذج وفي جدول الأسعار.

ملاحظة: اسم النموذج المعروض (مثل «Claude Opus 4.7») ليس نفسه معرّف API — انسخه دائمًا من وحدة التحكم.

الإحصاءات والتقارير

إحصاءات الاستخدام

في وحدة التحكم، يتضمّن قسم «إحصاءات الاستهلاك» بطاقات ملخّص ورسمًا بيانيًا أسبوعيًا للاستهلاك وجدول سجل الطلبات (التاريخ، النموذج، رموز السياق، التكلفة).

إجمالي الطلبات

إجمالي التكلفة

$—

النماذج المستخدمة

متوسط التكلفة

$—

المالية

المحفظة والشحن

تعتمد الواجهة على الدفع حسب الاستخدام . ترى رصيد محفظتك في وحدة التحكم وتشحنها عبر البوابة البنكية (دفع إلكتروني بالريال). دون اشتراك إلزامي — تدفع فقط مقابل ما تستهلكه.

  • يُعرض الرصيد بالدولار؛ ويتم سعر التحويل والدفع بالريال أثناء عملية الشحن.
  • عند نفاد الرصيد، تتوقف طلبات API حتى إعادة الشحن.
  • تفاصيل أسعار كل نموذج في وحدة تحكّم المطوّرين.

إدارة الأخطاء

الأخطاء الشائعة

401 Unauthorized

مفتاح API غير صالح أو منتهٍ. أنشئ مفتاحًا جديدًا من وحدة التحكم وتحقّق من ترويسة Authorization.

402 / Insufficient balance

رصيد المحفظة غير كافٍ — اشحن من قسم المحفظة.

404 Model not found

معرّف النموذج خاطئ. انسخه تمامًا من قائمة نماذج وحدة التحكم.

429 Rate limit

عدد الطلبات يتجاوز الحد — يُنصح بالتراجع الأسّي وإعادة المحاولة مع تأخير.

الأسئلة الشائعة

أسئلة المطوّرين الشائعة

هل هو متوافق مع OpenAI SDK الرسمي؟
نعم. يكفي ضبط base_url على https://api.chatqt.com/api/v1 وapi_key على مفتاح ChatQT.
ما الفرق بين api.chatqt.com/api و/api/v1؟
لـOpenAI SDK وn8n استخدم /api/v1 . بعض العملاء (مثل Claude CLI) يستخدمون /api بدون v1 — دليل Claude CLI و دليل n8n.
أين التوثيق الكامل؟
النسخة التفاعلية والمحدّثة في وحدة التحكم ← التوثيق. هذه الصفحة نظرة عامة وبداية سريعة.
هل أحتاج إلى VPN؟
لا — صُمّمت واجهة ChatQT API للوصول من إيران بدون VPN.

هل أنت مستعد للبناء باستخدام API؟

احصل على مفتاح API، وأرسل أول طلب، وتابِع الاستهلاك في وحدة التحكم.