API Reference
سطح ثابت تماماً - الدردشة، التجسيد، إعادة التدوير، الصور، الفيديو، 3D، الصوت، التصفيق، البحث، الكشف، الوظائف
EmpirioLabs يتحدث بأشكال طلبات متوافقة مع OpenAI وAnthropic. ضع أي SDK، وجهه إلى https://api.empiriolabs.ai، وقم بالتحقق باستخدام مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك. كل نقطة نهاية أدناه تعمل ضد أي عميل OpenAI أو Anthropic دون تغيير.
التوثيق
كل طلب يتطلب رمز حامل ويُقبل أي رئيس على كل نقطة نهاية:
سطح نقطة النهاية
دردشة منفتحة Streaming, tool calling, vision, audio input, JSON mode, structured output, reasoning controls.
(ب) الإكمالات السريعة المتوافقة مع المعايير المحاسبية الدولية للقطاع العام للنماذج التي تُعلِن (POST /v1/completions).
الانضمام المباشر لعملاء Anthropic SDK. tool_use / tool_result كتل ذهابا وإيابا بشكل نظيف.
الجينات، التحرير، الطلاء، تغيير الصور. مُضيفة، مُوقع 7 أيام.
إنتاج فيديو (آسينك) يُعيدُ a شغل - id; poll the jobs endpoint for the URL.
TTS plus real-time streaming TTS (Inworld), music / podcast / SFX generation, voice clone management.
مهام عميلة مستعملة طويلة المدى ابدأ، استطلاع، رسائل تيار، توقف مبكراً
همس / Deepgram / ببغاء. رفع متعدد الأجزاء أو file_url.
Exa، Tavily، Linkup، Perplexity البحث. فلاتر النطاق، النطاقات التاريخية، التحيز الجغرافي.
(أسينك) تُنتج أصولاً من 3 دي يُعيدُ a شغل id; poll for the signed GLB URL.
POST /v1/detect GPTZero AI-detection, bibliography scan, source analysis.
تركيبات متوافقة النص المتعدد اللغات + سفارات متعددة الوسائط.
إعادة ترتيب الوثيقة Sort retrieval candidates by relevance for RAG and search refinement.
مرر أيّ حرف علني في حقول المدخلات ولا يوجد تحميل، ولا إعادة تصميم - النواتج المولدة صالحة لمدة ٧ أيام.
Poll the status / result of any async generation. احتفظت الدولة بساعة واحدة بعد الإنجاز.
كتالوج حي بالتسعير، وكيما البارامترات، وأعلام القدرة، والمناطق.
مظاريف الأخطاء المفتوحة
إنجاز سلسلة
POST /v1/chat/completions
انقل أي نموذج يمكن الدردشة من الكتالوج كأنه model. يستخدم البث أحداثا أرسلها الخادم مع data: ... الأسطر وdata: [DONE] نهائي.
المعلمات المقبولة لكل نموذج موجودة في صفحة المستندات الخاصة به (مثل temperature، top_p، enable_thinking، reasoning_effort، web_search_tier). تصفحها تحت المزودين والنماذج.
البارامترات النموذجية عبر نقاط النهاية
يمكن إرسال المعلمات الخاصة بالنموذج المعلن عنها في صفحة النموذج وفي GET /v1/models/\{id\} إلى /v1/chat/completions و/v1/responses و/v1/messages عندما يدعم ذلك النموذج نقطة النهاية. تقوم البوابة بتكييف أشكال الطلبات بحيث تصل نفس الضوابط إلى النموذج الأساسي.
بالنسبة للنماذج القادرة على التفكير، يتم قبول enable_thinking وthinking_budget في جميع نقاط النهايات النصية الثلاث. على /v1/messages، يمكنك أيضا استخدام التفكير بأسلوب الأنثروبية:
وهذا يتوافق مع نفس enable_thinking=true وthinking_budget=1024 التحكم المستخدم في إتمام الدردشة والاستجابات.
إنجاز المجاملة
POST /v1/completions
استخدم هذه النقطة النهائية للعملاء المتوافقين مع OpenAI الذين لا يزالون يرسلون prompt خام بدلا من messages الدردشة. فقط النماذج التي تدرج POST /v1/completions بsupported_endpoints تقبل هذا الشكل.
ويستخدم الترميم أحداث سيرفر-سنت ويشتمل على الاستخدام عندما تبلغ الخدمة النموذجية بذلك.
Anthropic الرسائل
POST /v1/messages
ويمكن الوصول إلى أي زبون من شركة Anthropic SDK - وهي نفس النماذج التي يمكن الوصول إليها في /v1/chat/completions و /v1/responses
tool_use وكتلة tool_result ذهابا وإيابا بشكل نظيف. يتم الحفاظ على مصفوفات محتوى text-plus-tool_use مختلطة.
توليد الصور
POST /v1/images/generations
تدفقات تحرير الصور تقبل image: ["https://..."] حتى الحد الموثق للنموذج (3 ل qwen-image-2-0، 9 ل wan-2-7-image، 14 ل seedream-5-0-lite). تنشئ أوضاع الصور مجموعات متماسكة - راجع صفحة كل نموذج للتبديل (التبديل).
URLs Returned URLs live on https://media.empiriolabs.ai and expire after 7 days. وفر أي شيء تريد الاحتفاظ به قبل أن تنتهي الطائرة
POST /v1/images/analysis يُجري تحليلاً للرؤية فقط (لا جيل) على صورة واحدة أو أكثر من صور المدخلات. Use for layout extraction, object detection, OCR, and similar inspection tasks where the model returns text or JSON describing the image rather than a new picture.
Video generation
POST /v1/videos/generations
دائمًا ما تكون مُندهشة - نقطة النهاية تُعيدُ a job_id
Audio generation
POST /v1/audio/speech تزامنة، يَعُودُ a إستضافَ URL by default; pass EL response_format: "b64_json"
POST /v1/audio/speech:stream TTS في الوقت الحقيقي. يرجع الأحداث المرسلة من الخادم أثناء توليف النموذج. أقل من 130 مللي ثانية time-to-first-byte على Inworld TTS Mini، وأقل من 250 مللي ثانية على Max. الاستخدام لأجهزة الصوت والتشغيل التفاعلي. مدعوم حاليا على Inworld TTS Mini / Max؛ تستخدم نماذج TTS الأخرى نقطة النهاية المتزامنة.
POST /v1/audio/generations الموسيقى، والبودكاست، وتوليد المؤثرات الصوتية. يغطي Stable Audio وGLM TTS وMOSS، SoulX Podcast حيث يختلف شكل prompt-to-audio عن TTS.
GET /v1/voices قائمة وإدارة الأصوات، بما في ذلك النسخ المخصصة للأصوات ل Inworld TTS. استخدم voice_id الرجوع في أي من نقطتي نهاية الكلام.
الوصف
POST /v1/audio/transcriptions
يقبل إما رفع متعدد الأجزاء file أو حمولة JSON مع file_url.
الملفات الطويلة (أكثر من 5 دقائق) ترسل تلقائيا إلى نظام المهام غير المتزامنة - حيث يتضمن الرد job_id بدلا من نص داخلي. استطلاع نقطة نهاية الوظائف لاسترجاع النص النهائي.
البحث والبحث
POST /v1/search سطح بحث موحد لنماذج الاسترجاع. المعلمات المقبولة بالضبط لكل نموذج موجودة في صفحة كل نموذج (على سبيل المثال، exa-search يعرض 28 باراما تشمل category، livecrawl، subpages، summary_query، code_tokens).
POST /v1/research البحث العميق / نماذج الاسترجاع متعددة الخطوات (Exa Research، Perplexity Deep Research، Linkup Deep Search). ينتج تقرير بحثي منظم مع مصادر مستشهد بها.
POST /v1/answer نماذج الأسئلة المباشرة (Exa Answer). يعيد إجابة موجزة مع الاستشهادات بدون الشكل الكامل للتقرير.
العملاء
مهام وكيل طويلة الأمد تستخدم الأدوات (حاليا موجهة إلى Manus). قدم رسالة واحدة، ثم قم باستطلاع للحالة ورسائل step-by-step، أو توقف مبكرا.
POST /v1/agents/run does double duty:
- بدون أن تبدأ مهمة جديدة The response carries the new
task_id. - مع
task_idيرسل رسالة متابعة إلى مهمة موجودة. يلتقط العميل الموضوع في خطوة التفكير التالية.
GET /v1/agents/\{task_id\} استرجاع الحالة الحالية للمهمة والنتيجة النهائية.
GET /v1/agents/\{task_id\}/messages سرد كل خطوة قام بها الوكيل حتى الآن. مفيد لتقديم تتبع منطقي حي إلى جانب الإجابة النهائية.
POST /v1/agents/\{task_id\}/stop توقف مهمة جارية. الفوترة تكتفي بالعمل الذي أنجزه الوكيل بالفعل.
3D Generation
POST /v1/3d/generations
جيل الصور إلى 3D هو أسينك. The endpoint returns a job_id and a polling URL; poll the jobs endpoint to retrieve the final signed GLB URL.
يعرض trellis-2-4b الصورة الكاملة، الدقة، سامبلر النموذج، الخام، وسطح تصدير الشبكة في صفحة النموذج.
الكشف
POST /v1/detect
نقطة نهاية متخصصة لتصنيف النص. حاليا يدعم GPTZero (اكتشاف الذكاء الاصطناعي، مسح الببليوغرافيا، تحليل المصدر). يختار scan_type كل نموذج المسار الأعلى؛ راجع وثائق كل نموذج لسطح المعلمات الكامل.
GPTZero is also reachable via EL /v1/chat/completions and /v1/responses pass the text on the message body and the gateway adapts the call. The detection summary comes back as the Assistant message; pass disable_formatting: true
المداخل
POST /v1/embeddings
تركيبات متوافقة ويتاح النص المتعدد اللغات والسفارات المتعددة الوسائط (النص + الصورة + الفيديو).
Reranks
POST /v1/reranks
documents المرشح حسب الصلة الدلالية query. يعيد الفهرس الأصلي لكل مستند بالإضافة إلى درجة الصلة 0-1 (أعلى = أكثر صلة). استخدم هذا لتشديد مخرجات مخزن متجه / BM25 / مسترد هجين قبل تمرير الضربات العليا إلى نموذج لغوي - وهو الخطوة الأخيرة القياسية في خط أنابيب RAG.
The optional instruct parameter swaps between QA retrieval (default) and pure semantic-similarity sorting - see the [qwen3-rerank model page](/ models/qwen3-rerank) for the full parameter table.
هدف الاستخدام
كل نقطة نهاية تحسب الاستخدام تعيد حقل usage على الاستجابة (وعلى جزء البث الطرفي). شكل القاعدة:
cost_usd- المبلغ الدقيق الذي تم تحصيل المبلغ الذي تم تحصيل حسابك مقابل الطلب. سلطة.prompt_tokens/completion_tokens/total_tokens- لعارضي الدردشة.- حقول الصراصير (
cache_read_input_tokens،cache_creation_input_tokens) - عندما يُطبق التأشيرة السريعة.
النماذج التي تحتوي على مستويات أو لكل مكالمة أو بأسعار متغيرة تضع حقول إضافية على usage لتتمكن من معرفة المعدل الذي تم تطبيقه:
- تسعير الطبقة / المتغيرات. يقوم العمال بختم مميز الطبقة على
usageعندما يكون البعد نفسه له أكثر من معدل واحد. المجال الأساسي هوpricing_tier_label(قابل للقراءة البشرية، مثل"Medium context"/"Pro"/"2K"). يمكن للعمال الأكبر سنا ختم البعد الخام مباشرة بدلا من ذلك (resolution،quality،mode،rate_tier). لوحة التحكم تعرض الشارة من أي جهاز موجود. - تسعير كل مكالمة. العمال الذين يرسمون الفواتير لكل أداة (بحث، جلب، تنفيذ الكود، إلخ) يحسبون طوابع تحت
tool_calls_details.<tool>.invocationأوtool_usage.<tool>. تقوم لوحة التحكم بتوسيع هذه النقاط إلى تقسيم لكل أداة تلقائيا. - التسعير لكل بعد. العمال الذين يحصلون على عدة أبعاد في طلب واحد (مثل رموز الاستشهادات + رموز الاستدلال + استعلامات البحث على نماذج البحث العميق) يختمعون كل بعد كمجاله الخاص (
citation_tokens،reasoning_tokens،num_search_queries، إلخ).
نفس الحقول تدفع تقسيم شارة الطبقة وكل أداة في سجلات استخدام لوحة التحكم، كما يتم إرجاعها بواسطة نقطة نهاية تاريخ GET /v1/account/usage تحت metadata.worker_usage كل حدث (بالإضافة إلى مصفوفة tool_breakdown منظمة لنماذج كل مكالمة). لذا سواء قرأت استخدام الردود الحية، أو سجل استخدام الحسابات، أو لوحة التحكم الخاصة بك، فإن التصنيف وتوزيع الفوترة يتطابقان تماما.
الشاحنات الصغيرة
EmpirioLabs لا تستضيف رفع المستخدمين. تمرير أي عنوان URL عام مباشرة إلى حقل الإدخال في نقطة نهاية النموذج:
بالنسبة لنقل الصوت تحديدا، فإن الرفع المباشر متعدد الأجزاء على /v1/audio/transcriptions هو المسار المدعوم للمقاطع الخاصة التي ليست على عنوان URL - حيث تتدفق تلك البايتات مباشرة إلى عامل speech-to-text بدون تخزين مستمر.
يتم التوقيع على سجلات الإنتاج المولدة وتنتهي صلاحيتها**. لا توجد نقطة نهاية لإعادة التصميم. وفّر أي شيء تحتاج إلى الاحتفاظ به - كل من URL والثنائي - داخل تلك النافذة.
وظائف الأسينك
GET /v1/jobs/<job-id>
وتُحتفظ ولاية العمل لمدة 10 ساعات** بعد إتمامها.
عندما status هو completed ، result
مهلة HTTP الواردة هي 15 دقيقة. يجب أن تضبط عمليات الدردشة المتزامنة التي تعمل بالقرب من هذا الحد stream=true بحيث يتدفق جزء من الإخراج ويبقى الاتصال دافئا.
النماذج
GET /v1/models - اذكر كل موديل متاح.
GET /v1/models/<model-id> schema الكامل لنموذج واحد، بما في ذلك طاولات البارامترات.
GET /v1/models?format=openrouter يعيد شكل قائمة النموذج OpenRouter للنماذج التي تم تمييزها جاهزة لدخول الشريك. انظر OpenRouter Model Listing للحصول على حقول الاستجابة الدقيقة.
كل نموذج يعود:
أعلام مشوهة
العديد من نقاط النهاية التي تتحدث وتبحث وتبحث وتعيد ترتيب نقاط النهاية تقبل علامة disable_formatting=true. عند تعيينه على نموذج داعم، يتخطى العامل EmpirioLabs تنسيق الخادم (إعادة كتابة الاستشهاد، كتلة المراجع، ماركداون كتلة التفكير، إلخ) ويعيد شكل الحمولة الأعلى حرفيا.
يتم الإعلان عن التغطية لكل نموذج. تحقق من supports_passthrough في GET /v1/models/\{id\} للتأكد من أن الطراز المحدد يكرم العلم. العارضات التي تروج supports_passthrough: true تقبل أيضا الأسماء المستعارة raw=true passthrough=true وraw_response=true. النماذج التي لا تحتوي على هذا الحقل تقبل فقط الشكل disable_formatting=true القانوني (أو لا تحترم التمرير على الإطلاق). تدرج بطاقة النموذج أي اسم مستعار يقبل كل نموذج.
ولا تقبل الصور والفيديو والتوليد الصوتي والوصف وترسيخ النقاط النهائية هذا العلم، لأنه لا توجد طبقة مصممة للتحلل من هذه النقاط.
الاحتفاظ بوسائط الإعلام المولدة
وتعاد الصور المولدة والفيديوات والصوتية كما وقع عليها الاتحاد الثوري للقوات المسلحة التي تكون صالحة لمدة سبعة أيام**. وبعد ذلك، يتوقّف الاتحاد الثوري عن العمل وتختفي الأصول - لا توجد نقطة نهاية جديدة. وفر أي شيء تريد الاحتفاظ به قبل أن تنتهي نافذة السبعة أيام
الأخطاء
OpenAI الظرف على الدردشة / الردود / الصور / الفيديوهات / الصوت / البحث / التضمين / إعادة الترتيب:
Anthropic الظرف على /v1/messages:
المراجع
(ج) أن تُجمّع الكيماويات المحتوية على البارامترات في إطار [الأقسام والنماذج] (/المقدمين). وعندما تضغط على نموذج محدد، فإن كل بارامتر يقبله النموذج - من النوع، التقصير، النطاق، القيم المسموح بها، الأعلام المشروطة - موثق في جدول مستمد من قاعدة البيانات الحية.
