تكوين رسالة
يحتوي الطلب على model وmessages وmax_tokens؛ وتُرسل تعليمة النظام في حقل system منفصل. حافظ على الأدوار وترتيب الرسائل حتى يمكن لإعادة المحاولة إعادة إنتاج السياق.
تستدعي طلبات HTTP الخام https://cicora.ai/api/v1/messages, بينما يتلقى Messages SDK جذر البوابة فقط https://cicora.ai/api ويضيف /v1/messages بنفسه.
طلب Messages API
bash
curl --request POST https://cicora.ai/api/v1/messages \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "anthropic/claude-sonnet-5",
"max_tokens": 500,
"system": "Answer with a compact checklist.",
"messages": [{"role": "user", "content": "Prepare a release plan."}]
}'الأدوات والبث
- أضف tools وtool_choice فقط للنماذج التي تدعمهما.
- تعامل مع وضع البث كتسلسل أحداث، لا ككائن JSON واحد.
- تأكد من بنية وسائط الأداة قبل تنفيذ أي إجراء.
اختيار تنسيق
لا تخلط حقول تنسيقين في طلب واحد. اختر chat أو messages عند حدود العميل ووحّد السجل الداخلي مرة واحدة.
اختبر الترحيل باستخدام محادثة محفوظة منزوعة الهوية، تتضمن نتيجة أداة وسياقًا طويلًا.