الانتقال إلى المحتوى الرئيسي

​
الخطوة 1: ابدأ بأرصدة التجربة

1

إنشاء حساب

سجّل في aisonar.dev باستخدام بريدك الإلكتروني أو Gmail أو حساب GitHub.
2

استخدم أرصدة التجربة المضمنة

يتضمن حسابك أرصدة تجربة للطلبات التجريبية الصغيرة الأولى. لا تحتاج إلى الشحن قبل Quickstart.
3

أنشئ أو انسخ مفتاح API

انتقل إلى Dashboard → API Keys وأنشئ مفتاحًا جديدًا أو انسخ مفتاحًا موجودًا. احتفظ به بأمان لأن المفتاح الكامل يظهر مرة واحدة فقط.
احفظ مفتاح الـ API الخاص بك بأمان. لا تكشف عنه في شيفرة جانب العميل أو في مستودعات عامة.

​
الخطوة 2: تثبيت عميل

pip install openai

​
الخطوة 3: أجرِ طلبك الأول

بالنسبة لمعظم عمليات التكامل الجديدة، ابدأ بـ إكمالات الدردشة على POST /v1/chat/completions. 
curl https://api.aisonar.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'
استخدم POST /v1/responses فقط عندما تحتاج صراحةً إلى سلوك مخصص لـ Responses. بعض الحقول الخاصة بـ Responses تعتمد على النموذج المحدد ومسار التوجيه.

​
اشحن للاستخدام الإنتاجي

أرصدة التجربة المضمنة مخصصة للاختبارات الصغيرة الأولى. أضف أرصدة من Dashboard → Billing فقط عندما تكون مستعدًا للاستخدام الإنتاجي أو للاختبارات الأعلى حجمًا.

​
جرّب نماذج مختلفة

تدعم AI Sonar مئات النماذج. غيّر حقل model فقط: 
response = client.chat.completions.create(model="gpt-5.4", messages=[{"role": "user", "content": "Hello"}])
response = client.chat.completions.create(model="gpt-5-mini", messages=[{"role": "user", "content": "Hello"}])
response = client.chat.completions.create(model="claude-sonnet-4-6", messages=[{"role": "user", "content": "Hello"}])
response = client.chat.completions.create(model="gemini-2.5-flash", messages=[{"role": "user", "content": "Hello"}])
response = client.chat.completions.create(model="deepseek-r1", messages=[{"role": "user", "content": "Hello"}])

​
تمكين البث

stream = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Tell me a short story."}],
    stream=True
)

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

​
ما التالي؟

المصادقة

تعرّف على إدارة مفاتيح API والأمان.

OpenAI SDK

استخدم المسارات المتوافقة مع OpenAI /v1 مع حِزم OpenAI SDKs الحالية.

مرجع API

استعرض مرجع نقاط النهاية الكامل.

النماذج

تصفح توفر النماذج الحالي والأسعار.