الانتقال إلى المحتوى الرئيسي
POST
اتخاذ قرارات منظّمة
نقطة النهاية هذه في المرحلة التجريبية. أرسل input ومصفوفة مرتّبة من questions إلى POST /v1/decisions، واحصل على إجابة واحدة ذات نوع محدد لكل سؤال، مع الاحتمالات، وبالترتيب نفسه.

اتخذ قرارًا

يطرح هذا الطلب سؤالًا واحدًا من كل نوع. يحتاج إلى مفتاح Phaseo API وإلى مسار openai/gpt-6-luna متاح.
الاستجابة (القيم توضيحية):

اكتب الأسئلة

input سلسلة نصية، أو مصفوفة من رسائل user يكون content فيها سلسلة نصية أو قائمة من أجزاء input_text وinput_image وinput_audio وinput_video. الحقل name اختياري؛ وتحافظ الإجابات على ترتيب الطلب، بما في ذلك الأسئلة غير المسمّاة والأسماء المكررة. يحمل الطلب الواحد 128 سؤالًا كحد أقصى، باستثناء google/gemini-decision-1 الذي يقبل حتى 1,000 سؤال، وparallel/decisions-fast الذي يقبل حتى 100، وClef الذي يقبل حتى 64. يعيد الطلب الذي يتجاوز حد النموذج الرمز 400. تعود قيم الخيارات المنطقية بوصفها قيمًا منطقية. يُرجع النموذج الذي يرفض الإجابة عن سؤال type: "refusal" له. الأنواع التي يدعمها كل نموذج مدرجة في اختر نموذجًا. توضع الصور في أجزاء input_image بوصفها عناوين data URL. لا تعمل عناوين HTTPS للصور المستضافة إلا على نماذج Base Labs ‏(baselabs/elephant-1 وbaselabs/mammoth-1 وbaselabs/joey-1)، ويجب أن تكون على Amazon S3 أو Google Cloud Storage أو Azure Blob Storage. يحمل الطلب 128 صورة على الأكثر، وهو ما يقبله Luna؛ ويضع المزوّدون الآخرون حدودًا أقل. يتطلب detail صريح للصورة وsafety_identifier مسارًا لدى OpenAI.

استخدم تنسيق state الأقدم

لا تزال الطلبات التي تحتوي state وخريطة من الأسئلة المسمّاة تعمل، وتُرجع إجابات مفهرسة بالأسماء نفسها. يتطلب Together Tev ‏(together/tev1-4b-experimental) هذا التنسيق، لأنه يُرجع تسمية بلا احتمالات، ولا يجيب إلا عن أسئلة choice. يستخدم Respan Span-01 هذا التنسيق أيضًا. لا تخلط بين التنسيقين: input مع state أو images يُرجع 400.
  • state: سلسلة نصية أو كائن أو مصفوفة تحتوي المعلومات المراد تقييمها.
  • questions: حتى 128 سؤالًا مسمّى، أو أكثر في النماذج ذات الحد الأعلى. يضبط كل منها type على noul (نعم/لا) أو choice أو score، إضافة إلى instructions. تأخذ أسئلة الاختيار criteria بوصفها خريطة من الخيار إلى وصفه؛ وتأخذ أسئلة الدرجات criteria بوصفها مصفوفة من وصفين للمستويات على الأقل.
  • تستخدم أسئلة locate الحقل instructions فقط، وتتطلب state نصيًا من نوع string بلا images؛ راجع Perplexity Decider.
  • images: حتى أربع صور PNG أو JPEG أو WebP، بوصفها عناوين data: أو كائنات { "content_type", "base64" }.
  • model: القيمة الافتراضية typesafe/jev-1.13.0 عند حذفه.
تستخدم الإجابات المفاتيح نفسها الموجودة في questions. تتضمن إجابات choice الخيار المحدد والاحتمالات والثقة؛ وتتضمن إجابات noul احتمالًا بين 0 و1؛ وتتضمن إجابات score درجة مرجّحة بالاحتمالات ومفتاحًا للمستويات واحتمالات وثقة.

اختر نموذجًا

تحقق من توفر النموذج قبل استدعاء أي من هذه النماذج. tokens الإخراج مجانية في كل نموذج مدرج بسعر.

TypeSafe Jev

استخدم typesafe/jev-1.13.0 لـ Jev 1.13، أو typesafe/jev-latest لمتابعة أحدث إصدار من Jev. لدلالات الأسئلة لدى المزوّد، راجع مرجع API الخاص بـ TypeSafe. على مسارات TypeSafe الداعمة، يقبل Jev 1.13 و1.14 صور PNG أو JPEG مضمّنة عبر input_image أو الحقل الأقدم images. يبني Phaseo أصول الصور الخاصة بـ TypeSafe ويفعّل دعم الصور تلقائيًا. يجب أن تستوفي الصور حدود الصور لدى TypeSafe: 16 MiB على الأكثر لكل صورة، ومن 256 إلى 1568 بكسل لكل ضلع، و78,400 بكسل إجماليًا على الأقل. يتحقق TypeSafe من الأبعاد والترميز ولا يغيّر حجم الصور المرفوضة. يقتصر جسم JSON المحوَّل المُرسل إلى المزوّد على 32 MiB. تستخدم tokens الصور سعر الإدخال العادي. يتطلب box (على المسارات الداعمة مثل Jev 1.14) صورة، ولا يأخذ معايير، ويُرجع مربعًا محيطًا واحدًا مع الثقة. تتراوح حوافه بين 0 و1، مقيسةً من الزاوية العلوية اليسرى. يُرجع Box دائمًا مستطيلًا، لذا اقرنه بسؤال predicate عن الوجود عندما قد يكون الهدف غائبًا. مع الحقل الأقدم images، أشر إلى images[0]؛ ومع الإدخال المرتّب، أشر إلى الصورة الأولى أو [Image 0]. راجع عقد Box. اضبط provider_options.typesafe.long_context على true لرفع حدود السياق لكل طلب ولكل سؤال إلى 262k token، بدلًا من القيم الافتراضية البالغة 64k لكل طلب و32k لكل سؤال. يكلّف السياق الطويل السعر نفسه لكل token. الصور وBox والسياق الطويل قدرات تجريبية لدى المزوّد.

Cloudflare Clef وClef Flash

يعمل cloudflare/clef وcloudflare/clef-flash على Cloudflare Workers AI. لـ Clef نافذة سياق من 65,536 token، ولـ Clef Flash نافذة من 24,576 token.
يقبل images أيضًا سلسلة data:image/png;base64,.... يقبل Clef حتى أربع صور PNG أو JPEG أو WebP، كل منها 4 MiB و16 ميغابكسل على الأكثر، مع 8 MiB على الأكثر من بيانات الصور بعد فك الترميز وجسم طلب حجمه 13 MiB. العناوين البعيدة غير مدعومة، ويتحقق Cloudflare من تنسيقات الصور وأبعادها. ترفض النماذج التي لا تدعم الصور طلبات الصور. يقبل Clef 64 سؤالًا على الأكثر، بمعرّفات تصل إلى 100 حرف من الأحرف أو الأرقام أو الشرطات السفلية أو النقاط أو الشرطات. تحتاج أسئلة الاختيار إلى 2–255 خيارًا، وأسئلة الدرجات إلى 2–10 مستويات. راجع توثيق Clef لدى Cloudflare.

Cloudflare Clef Omni

يقبل cloudflare/clef-omni النص والصور والصوت والفيديو. أجزاء الصوت والفيديو امتدادات من Phaseo لتنسيق الإدخال؛ إذ لا تقبل مسارات OpenAI إلا النص والصور. استبدل بايتات الصوت وعنوان الفيديو المؤقتة بوسائطك قبل إرسال هذا المثال.
أرسل الصوت بوصفه input_audio.data مع format: "wav" أو "mp3"، أو بوصفه input_audio.url مع عنوان HTTPS عام أو data URL صوتي مضمّن. يأخذ input_video.video_url سلسلة نصية أو { "url": "..." } يحمل عنوان HTTPS عامًا أو data URL مضمّنًا بتنسيق MP4/WebM. يجب أن تُرجع الخوادم البعيدة قيمة Content-Type المطابقة. يجلب Phaseo العناوين مع حدود للحجم وفحوص للعناوين الخاصة وإعادة التوجيه، ثم يضمّن الوسائط لـ Cloudflare؛ ولا تُرسل بيانات اعتماد المزوّد إلى خادم الوسائط أبدًا. يتحقق Cloudflare من ترميز الوسائط وأبعاد الصور ومدة المقاطع، ويأخذ عينات من الفيديو بمعدل إطارين في الثانية. يُستخدم صوت الفيديو عندما يكون لكل فيديو في الطلب صوت. تُحتسب tokens الوسائط ضمن السياق والفوترة؛ ويسوّي Phaseo الحساب بناءً على استخدام الإدخال الذي يبلغ عنه Cloudflare، ولا يضيف رسومًا منفصلة للصوت أو الفيديو. راجع عقد Omni لدى Cloudflare.

Liquid D1.2 وD1.2 Ultra

يستخدم liquid-ai/d1.2 وliquid-ai/d1.2-ultra تنسيق state الأقدم، مع ما يصل إلى أربع صور وثمانية مقاطع صوتية. أرسل audio بوصفه عناوين data: بترميز base64 ‏(WAV أو MP3 أو FLAC أو M4A أو OGG، بحد أقصى 24 MiB لكل عنوان، أي نحو 18 MiB من الصوت)؛ ولا تُدعم عناوين الصوت البعيدة. وإلى جانب noul وchoice وscore، يجيبان عن أنواع الأسئلة التالية: اضبط multiple: true على سؤال choice لتحصل على كل الخيارات المنطبقة في choices مع probabilities لكل خيار. تعيد النماذج الأخرى 400 لأنواع الأسئلة هذه وتجيب عن أسئلة multiple بخيار واحد؛ وتتجاهل النماذج التي لا تدعم إدخال الصوت الحقل audio. يقبل liquid-ai/d1 وliquid-ai/d1.1 وliquid-ai/d1-ultra النصوص والصور ويجيب عن noul وchoice وscore.

Liquid D1 وPerplexity Decider

Liquid D1 ‏(liquid-ai/d1:free) مجاني خلال الوصول المبكر التجريبي. يحتاج Perplexity Decider V1.3 ‏(perplexity/pplx-decider-v1.3، أو perplexity/pplx-decider-latest) وDecider Flash V1.3 ‏(perplexity/pplx-decider-flash-v1.3، أو perplexity/pplx-decider-flash-latest) إلى بيانات اعتماد مزوّد Perplexity في Phaseo. تستخدم حالة الصور لديهما عناوين data URL بتنسيق base64 لصور PNG أو JPEG أو WebP؛ وعناوين الصور البعيدة غير مدعومة. ويجيبان أيضًا عن أسئلة locate، التي تُعيد أجزاء input أو state النصي من نوع string المطابقة لـinstructions، مثل "email address". يحتوي كل مقطع على text منسوخ حرفيًا، وموضعي start وend محسوبين بنقاط ترميز Unicode (end غير شامل)، وscore تعني القيمة الأعلى فيه يقينًا أكبر؛ وتكون spans فارغة إذا لم يطابق شيء. لا يستخدم Locate أي criteria، ولا يقبل الصور أو الصوت أو الفيديو، ويعمل فقط على النماذج التي تذكر دعمه؛ وتُعيد النماذج الأخرى 400. درّبته Perplexity على مُدخلات يصل طولها إلى 8K tokens. في كليهما، يقبل سؤال الاختيار حتى 255 خيارًا، وسؤال الدرجات حتى 10 مستويات.

Inception Mercury Decide

يأخذ inception/mercury-decide أدلة نصية أو JSON. تقبل أسئلة الاختيار حتى 255 خيارًا، وأسئلة الدرجات حتى 10 مستويات. الصور والبث واستدعاء الأدوات غير مدعومة. سعر الإدخال البالغ $0.02 هو عرض Inception الترويجي بخصم 50%، ولا يوجد له تاريخ انتهاء منشور؛ راجع التسعير الحالي لدى المزوّد قبل الاستخدام.

Microsoft Decision

يعمل microsoft/microsoft-decision-1 على نشر في Azure Foundry، ويأخذ أدلة نصية أو JSON حتى 32,768 token. الوسائط والبث والأدوات وsafety_identifier وservice_tier غير مدعومة. راجع دليل Microsoft.

Respan Span-01

يستخدم Span-01 التنسيق الأقدم. يجب أن يكون state مقطع محادثة: مصفوفة input من الرسائل السابقة ورسالة مساعد في output. لا يجيب إلا عن أسئلة noul: قيمة noul هي احتمال وجود السلوك، ويعطي probabilities أيضًا احتمالَي الغياب وعدم القابلية للملاحظة.
تبدو الاستجابة هكذا:
respan/span-01:free هو نموذج Lite المجاني بحد يومي، ويقابل النموذج span-01-free لدى Respan. ويقابل respan/span-01 النموذج span-01-pro وتتولى Respan فوترته. Span-01 في مرحلة الوصول المبكر: يجب أن تفعّله Respan لمؤسستك، وأن تضيف مفتاح Respan API بوصفه بيانات اعتماد مزوّد Respan في Phaseo قبل استدعاء أي من النموذجين.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الجسم

application/json

يوصى بتنسيق OpenAI. يظل التنسيق القديم مدعومًا. تتبع الإجابة الطلب؛ لا تخلط التنسيقات.

model
string
مطلوب

معرّف نموذج Phaseo الأساسي أو الاسم المستعار لنموذج المزود.

Minimum string length: 1
input
مطلوب

نص أو رسائل مع صور مضمنة. الصوت والفيديو امتدادان من Phaseo للنماذج المتوافقة؛ لا تدعمهما مسارات قرارات OpenAI.

Maximum string length: 10485760
questions
object[]
مطلوب
Required array length: 1 - 1000 elements
models
string[]

نماذج احتياطية اختيارية ومرتبة تُجرَّب بعد model. الحقل model مطلوب وهو دائمًا النموذج الأساسي. عندما تفشل محاولة بالرمز 429 أو 500 أو 502 أو 503 أو 504، تُجرَّب الإدخالة التالية؛ وتُعاد الأخطاء الأخرى دون تغيير. يقبل ما يصل إلى 25 معرّف نموذج أو إعدادًا مسبقًا؛ وتُتجاهل الإدخالات المكررة والإدخالات المطابقة لـ model. يُتحقق من كل محاولة وتُسجَّل وتُحتسب تكلفتها كطلب مستقل، ويعرض الحقل model في الاستجابة وتتبّع التوجيه النموذج الذي خدم الطلب. لا تنتقل طلبات البث إلى نموذج احتياطي إلا قبل إرسال البايت الأول، ولا تنتقل مهام الفيديو والموسيقى إلا عند الإرسال. ترفض طلبات batch وrealtime وcouncil الحقل models. تكون الأولوية للنماذج الاحتياطية المحددة في مسار ديناميكي، ولا يمكن الجمع بين phaseo/auto وmodels.

Required array length: 1 - 25 elements
Minimum string length: 1
مثال:
provider_options
object
safety_identifier
string | null

معرّف مستخدم مبهم. مسارات OpenAI فقط.

Maximum string length: 128
meta
boolean
افتراضي:false
echo_upstream_request
boolean
debug
object

عناصر تحكم تصحيح أخطاء البوابة. لا تُمرر هذه العلامات إلى المزوّد مطلقًا.

provider
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

routing
object

تفضيلات توجيه المزوّد لاختياره عبر البوابة.

metadata
object

الاستجابة

200 - application/json

استجابة القرارات المنظّمة

إجابات مرتبة لـ input/المصفوفة؛ خريطة مسماة لـ state/الخريطة القديمة.

model
string
مطلوب
answers
object[]
مطلوب

إجابة لكل سؤال بالترتيب، حتى دون أسماء أو بأسماء متكررة.

usage
object
مطلوب
request_id
string | null
meta
object
آخر تعديل في ١٦ نوفمبر ٢٠٢٦