Skip to main content
POST
إنشاء دفعة
يتطلب الوصول إلى الميزات التجريبية في مساحة العمل. راجع مهام الفيديو والمعالجة على دفعات لمعرفة الإعداد والويب هوك والتعامل مع النتائج.

التفويضات

Authorization
string
header
مطلوب

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

الجسم

application/json
provider_options
object

امتدادات محددة بمعرّف المزوّد الأساسي. يقبل OpenAI الحقل output_expires_after ويقبل Mistral الحقل metadata. تُطبق خيارات المزوّد المحدد فقط. لا تكرر خياراً في المستوى الأعلى. لا يمكن للخيارات تجاوز الصفوف المُسعّرة أو النماذج أو الملفات.

model
string

معرّف النموذج المستخدم لاستنتاج مزوّد الدفعة الأعلى. قد تتضمن صفوف الطلب أيضاً body.model؛ ويُفضّل النموذج في المستوى الأعلى.

prompts
string[]

صيغة مختصرة لموجه بسيط. يحوّل Phaseo كل موجه إلى صف دفعة أصلي لدى المزوّد للنموذج المحدد.

items
object[]

صيغة مختصرة لموجه منظم. قد تتضمن العناصر id وcustom_id وprompt وmessages وinput وsystem وmax_tokens وtemperature أوbody متقدماً.

system
string

تعليمة نظام اختيارية تُطبق على صفوف الموجهات المختصرة.

max_tokens
integer

حد أقصى اختياري للرموز يُطبق على صفوف الموجهات المختصرة.

temperature
number

درجة حرارة أخذ عينات اختيارية تُطبق على صفوف الموجهات المختصرة.

input_file_id
string

معرّف ملف موجود لدى المزوّد لإنشاء دفعة عبر رفع ملف.

requests
object[]

صفوف طلبات دفعات متقدمة. قدم واحداً فقط من prompts أوitems أوrequests أوinput_file_id.

endpoint
enum<string>

صيغة الطلب الموجهة للمستدعي. يستخدم كل طلب في الدفعة نقطة النهاية هذه. عند الإغفال يختار Phaseo قيمة افتراضية أصلية لدى المزوّد بناءً على النموذج.

الخيارات المتاحة:
/v1/chat/completions,
/v1/responses,
/v1/messages,
/v1/embeddings,
/v1/generateContent
completion_window
string
metadata
object
session_id
string

معرّف فريد لتجميع الطلبات المرتبطة (مثل محادثة أو سير عمل وكيل) لأغراض قابلية المراقبة.

Maximum string length: 256
webhook
object
webhook_endpoint_id
string

اسم بديل ملائم لـwebhook.endpoint_id.

debug
object

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

provider
object

قيد توجيه متقدم. ينبغي لمعظم الطلبات الاعتماد على استنتاج المزوّد بناءً على النموذج.

الاستجابة

استجابة حالة الدفعة

id
string
native_batch_id
string | null

معرّف الدفعة الأصلي لدى المزوّد عندما يختلف عن معرّف البوابة.

object
string
endpoint
string
errors
object
input_file_id
string
completion_window
string
status
string
lifecycle_status
enum<string>

حالة دورة الحياة غير المتزامنة الموحدة لمستهلكي الاستطلاع وWebSocket وwebhook.

الخيارات المتاحة:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

نسبة إكمال تقريبية للدفعة مشتقة من أعداد طلبات المزوّد عند توفرها. تبلغ الدفعات المكتملة عن 100.

النطاق المطلوب: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

عنوان WebSocket للاشتراك في تحديثات دورة الحياة الموحدة للمهام غير المتزامنة.

cancel_url
string<uri> | null

محجوز للتوافق؛ قيمته حالياً null دائماً.

results_url
string<uri> | null

عنوان تنزيل Phaseo JSONL يتطلب المصادقة للدفعات المدعومة في حالة نهائية. يكون null أثناء المعالجة. قد لا يكون للدفعة النهائية ناتج. استخدم مفتاح API من مساحة العمل المالكة؛ تنطبق حدود الاحتفاظ لدى المزوّد.

output_file_id
string
error_file_id
string
created_at
integer
in_progress_at
integer
expires_at
integer
finalizing_at
integer
completed_at
integer
failed_at
integer
expired_at
integer
cancelling_at
integer
cancelled_at
integer
request_counts
object
metadata
object
request_id
string
provider
string
session_id
string
webhook
object

إعداد webhook غير المتزامن بعد تنقيح البيانات الحساسة مع حالة التسليم. لا تُرجع الأسرار أبداً؛ يشير has_secret إلى تفعيل عمليات التسليم الموقّعة. تتضمن عمليات التسليم الموقّعة ترويسات x-phaseo-signature وx-phaseo-timestamp وx-phaseo-event-id وx-phaseo-event-type وx-phaseo-delivery-key وx-phaseo-attempt وx-phaseo-max-attempts.

next_webhook_retry_at
string | null
last_webhook_progress
number | null
last_webhook_progress_at
string | null
last_webhook_dispatched_at
string | null
finalized_at
string | null
pricing_lines
object[]
usage
object

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

billing
object
آخر تعديل في ٢ أكتوبر ٢٠٢٦