مركز المطورين

ابنِ باستخدام Panel Studio

226 مسار API. Python SDK. Webhooks بتقنية HMAC. كل ما تحتاجه لدمج لوحات المستهلكين الاصطناعية في منتجك.

احصل على مفتاح API عرض التكاملات
بدء سريع

ثلاث خطوات لإنشاء لوحتك الأولى

1

احصل على مفتاح API الخاص بك

سجل للحصول على حساب مجاني. مفتاحك متاح فورًا.

سجل هنا
2

ثبّت الـ SDK

أمر واحد. لا توجد تبعيات تتجاوز الطلبات.

pip install kronaxis
3

أنشئ لوحتك الأولى

حدد الفئة السكانية المستهدفة واطرح سؤالك الأول. النتائج في دقائق.

Python SDK

جاهز للإنتاج في دقائق

Python 
from kronaxis import PanelStudio

ps = PanelStudio(api_key="your_key")

# إنشاء لوحة
panel = ps.panels.create(
    name="UK Retail Panel",
    country="GB",
    size=100,
    demographics={"age_range": "25-54"}
)

# تشغيل محفز
result = ps.conversations.create(
    panel_id=panel["id"],
    stimulus="Your favourite brand just increased prices by 20%. What do you do?",
    sample_size=50
)

# تصدير النتائج
ps.export.jsonl(panel["id"], path="results.jsonl")
نقاط النهاية الرئيسية

مسارات API الأساسية

يقدم Panel Studio 226 مسارًا عبر اللوحات، الشخصيات، المحادثات، التصديرات، الاستبيانات، والتكاملات. هذه هي الأكثر استخدامًا.

الطريقة نقطة النهاية الوصف
POST /api/panels إنشاء لوحة جديدة
GET /api/panels عرض لوحاتك
POST /api/panels/{id}/conversations بدء محادثة
POST /api/panels/{id}/conversations/{cid}/turns إضافة دور متابعة
GET /api/panels/{id}/personas عرض شخصيات اللوحة
POST /api/panels/{id}/export/jsonl تصدير كـ JSONL
POST /api/panels/{id}/export/parquet تصدير كـ Parquet
POST /api/panels/{id}/export/pptx تصدير كـ PowerPoint
POST /api/webhooks إنشاء اشتراك webhook
GET /api/integrations عرض التكاملات المتاحة
المصادقة

مصادقة بسيطة بمفتاح API

مرر مفتاح API الخاص بك في ترويسة X-API-Key مع كل طلب. يتم إصدار المفاتيح فورًا عند التسجيل.

curl -H "X-API-Key: your_key" \
     https://panel.kronaxis.co.uk/api/panels

الطبقة المجانية

10 شخصيات، 10 أسئلة شهريًا. وصول كامل إلى API. لا تتطلب بطاقة ائتمان.

الطبقات المدفوعة

شخصيات وأسئلة غير محدودة. تتبع الاستدلال السببي. دعم ذو أولوية. راجع التسعير للحصول على التفاصيل.

Webhooks

تسليم الأحداث في الوقت الفعلي

يتم توقيع كل webhook باستخدام HMAC SHA-256 باستخدام مفتاحك السري. تحقق من ترويسة X-Kronaxis-Signature من جانب الخادم لضمان الأصالة. يتم إعادة محاولة التسليمات الفاشلة مع تراجع أسي.

conversation.completed
يتم تشغيله عند جمع جميع استجابات الشخصيات لدور معين.
panel.created
يتم تشغيله عند اكتمال بناء لوحة جديدة وتجهيز الشخصيات.
export.ready
يتم تشغيله عندما يكون ملف تصدير JSONL أو Parquet أو PPTX جاهزًا للتنزيل.

ابدأ البناء اليوم

احصل على مفتاح API مجاني وقم بتشغيل لوحتك الأولى في أقل من خمس دقائق.

احصل على مفتاح API عرض التسعير