المطورون
انقل المساعد إلى تطبيقك أو عميل MCP أو موقعك. التكلفة في كل مكان مثل المحادثة.
ابدأ في 3 خطوات
- 1
أنشئ مفتاحك
احصل على مفتاح API من الملف الشخصي ← المطوِّر. يعمل المفتاح باسم حسابك.
إدارة مفاتيح API → - 2
جرّبه هنا
في ساحة التجربة أدناه اختر نقطة نهاية، والصق مفتاحك، واضغط اختبار.
ساحة التجربة → - 3
أضفه إلى شيفرتك
انسخ المثال الجاهز بـ cURL أو JavaScript أو Python؛ وMCP والأداة في علامات التبويب.
الوثائق →
ساحة التجربة
اختر نقطة نهاية، واملأ المعاملات، واضغط اختبار. الطلبات حقيقية؛ انسخ الشيفرة كما هي.
POST/api/v1/conversations
بدء محادثة: { text, locale?, model?, tools? } — أنشئ بـ tools صورًا أو فيديو أو موسيقى أو صوتًا.
curl -X POST "https://yapayzeka.my/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"ar"}'نص الاستجابة
ستظهر الاستجابة هنا.
الوثائق
الوسائط المتعددة
أدوات المحادثة متاحة في API أيضًا: الصور والفيديو والموسيقى والصوت والبحث. أضفها بحقل tools؛ تعود الملفات المُنشأة في مصفوفة media بعنوان عام.
| الإجراء | الاسم في API | التكلفة |
|---|---|---|
| ابحث في الويب | web_search | رصيد واحد |
| أنشئ صورة | generate_image | 3 أرصدة |
| أنشئ فيديو | generate_video | 10 أرصدة / ثانية |
| أنشئ موسيقى | generate_music | 5 أرصدة |
| قراءة النص بصوت | speak_text | رصيد واحد |
curl -X POST https://yapayzeka.my/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "a red fox in the snow, watercolor", "tools": ["generate_image"]}'
# GET /api/v1/conversations/{id}
{
"pending": false,
"generating": false,
"messages": [
{ "role": "assistant", "content": "…", "media": [
{ "name": "image.png", "type": "image/png", "url": "https://…/image.png" }
] }
]
}تصل الصور مع الإجابة. يُنشأ الفيديو والموسيقى في الخلفية: اقرأ المحادثة حتى يصبح generating قيمة false. الأدوات التي تتطلب رفع ملف غير متاحة في API.