رسوم تقنية لبرامجك ولوكلاء الذكاء الاصطناعي لديك
محرك الرسم نفسه الذي يستخدمه Occlusia Studio، يعمل على خوادم Occlusia خلف REST API وخادم MCP. أرسل نموذجًا ثلاثي الأبعاد وتكوينًا؛ واستلم المساقط الأفقية والمقاطع والواجهات بصيغة DXF أو PDF أو SVG أو PNG أو JPEG — وهي الرسومات التي ينتجها Studio، بايتًا ببايت.
REST API
يحمل كل طلب مفتاح API أو رمز وصول OAuth. والجلسة محرك خاص بك، بملفاته الخاصة: ارفع، ونفّذ الأوامر، ونزّل، وأنهِها.
https://api.occlusia.app/v1/engine
KEY=occ_sk_… # Account › API keys
API=https://api.occlusia.app/v1/engine
AUTH="Authorization: Bearer $KEY"
JSON="Content-Type: application/json"
# 1. A session: an engine of your own, with its own files
S=$(curl -s -X POST $API/sessions -H "$AUTH" | jq -r .id)
# 2. The model and your graphic standard
curl -T house.skp $API/sessions/$S/files/house.skp -H "$AUTH"
curl -T standard.occc $API/sessions/$S/files/standard.occc -H "$AUTH"
# 3. Open the model (1 credit), apply the configuration (free)
curl $API/sessions/$S/commands/model.open -H "$AUTH" -H "$JSON" -d '{"path":"house.skp"}'
curl $API/sessions/$S/commands/config.set -H "$AUTH" -H "$JSON" -d '{"path":"standard.occc"}'
# 4. Export one view as DXF (1 credit per drawing)
curl $API/sessions/$S/commands/export -H "$AUTH" -H "$JSON" \
-d '{"format":"dxf","sections":"Section A-A","out":"section-a.dxf"}'
# 5. Download it, then end the session: its files are deleted with it
curl -o section-a.dxf $API/sessions/$S/files/section-a.dxf -H "$AUTH"
curl -X DELETE $API/sessions/$S -H "$AUTH"واجهة API كاملة بصيغة OpenAPI في /v1/engine/openapi.json، وكل أمر مع JSON Schema الخاص به في GET /v1/engine/commands. دليل REST API
محرك واحد خلف Studio وAPI وMCP
GET /v1/engine.- فتح النماذج
- نماذج SketchUp (.skp) وIFC وFBX، ونماذج Occlusia الخاصة .occs ومشاريع .occp.
- قراءتها
- الكائنات ومجموعاتها، والمناظر، والملاحظات، والمناسيب، والطبقات، وأنماط الخطوط، والإعدادات المسبقة للتهشير.
- تنسيقها
- أي إعداد لكائن أو منظر أو ملاحظة أو طبقة — أو تكوين .occc كامل، يُتحقَّق منه قبل تطبيقه.
- المعاينة
- منظر بصيغة PNG أو JPEG أو SVG، بحد أقصى 2048 بكسل على ضلعه الأطول: وهو ما ينظر إليه وكيل الذكاء الاصطناعي.
- التصدير
- SVG وDXF وPDF — صفحة لكل منظر أو مستند واحد، بورقه واتجاهه ومقياسه — وPNG وJPEG.
- Auto config
- التكوين الذي يقترحه Occlusia انطلاقًا من أسماء الكائنات، مع بيان تكلفته قبل التشغيل.
خادم MCP، لأدوات الذكاء الاصطناعي
عبر Streamable HTTP. لا تحتاج أداة الذكاء الاصطناعي إلا إلى العنوان: ففي المرة الأولى تحيلك إلى occlusia.app لتوافق عليها، ثم تعود برمز. ولا يوجد مفتاح تنسخه.
https://api.occlusia.app/v1/mcp
- Claude
- Settings › Connectors › Add custom connector، ثم العنوان.
- ChatGPT
- أضف خادم MCP مخصصًا بالعنوان، مع OAuth وسيلةً للمصادقة.
- Cursor وVS Code وغيرهما
- أضف خادم MCP بعيدًا (Streamable HTTP) بالعنوان: فتسجّل هذه الأدوات دخولك بالطريقة نفسها.
Claude Code: أمر واحد، ثم /mcp لتسجيل الدخول — أو الأمر نفسه بمفتاح API، للأدوات التي ترسل ترويسة.
claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcpclaude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
--header "Authorization: Bearer occ_sk_…"تُدفع بالنقاط، كما في Studio
تكلّف عمليات التصدير وAuto config ما تكلّفه في Studio. ولأن خوادم Occlusia تؤدي العمل الذي يؤديه جهازك في Studio، فإن فتح نموذج يكلّف نقطة واحدة وكل رسم جديد يُحسب نقطة واحدة؛ والرسم نفسه مرة أخرى في الجلسة نفسها مجاني، وكذلك السرد والقراءة والإعدادات. ويذكر كل جواب مدفوع تكلفته والرصيد بعدها.
خلال الوصول المبكر لا يُؤخذ شيء، بما يصل إلى عمل API يعادل 500 نقطة لكل حساب في أي فترة مدتها 24 ساعة.
للمضي أبعد
تدمج Occlusia في منتجك؟
الحسابات التقنية المخصصة، والحدود المخصصة، والعلامة البيضاء واستخدام OEM تُتفق بشأنها بشكل منفصل، كتابةً.