OpenAI Web Search
Generate cited answers using web search.
بحث ويب مدعوم بنموذج (OpenAI).
أنشئ إجابة موثّقة بمصادر باستخدام نموذج OpenAI والبحث على الويب. قدّم input كسلسلة نصية أو مصفوفة رسائل. تتولّى الخدمة إدارة النموذج والأدوات وحدّ البحث. الاستجابة كائن Responses يتضمّن output فيه عناصر web_search_call ورسائل مع استشهادات URL. يبلّغ usage عن استهلاك الموارد، لا عن رسم Felo.
مرجع التسعير
- القياس: مكوّنات الاستجابة المقيسة.
- تقدير الطلب المرجعي: 0.3 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringinputمطلوب
سؤالك أو تعليماتك، بالصيغة نفسها لحقل
inputفي OpenAI Responses API. تُقبل أيضًا مصفوفة رسائل. - النوع: stringinstructions
تعليمات عامة اختيارية لتوجيه نبرة الإجابة أو تنسيقها.
- النوع: integermax
_output _tokens حد أقصى اختياري لعدد الرموز المولّدة في الإجابة.
- النوع: object200
كائن OpenAI Responses قياسي. تتداخل
output[]بين عناصر web_search_call ورسالة الإجابة الموثّقة؛ وعدد عناصر web_search_call هو عدد عمليات البحث المحتسبة.- النوع: stringid
- النوع: stringobject
- النوع: array object[]output
عناصر مرتّبة: web_search_call (عمليات البحث المنفذة) وmessage (الإجابة المستشهد بها).
كائن فارغ - النوع: stringstatus
- النوع: objectusage
- inputالنوع: integer
_tokens Integer numbers.
- inputالنوع: object
_tokens _details - cachedالنوع: integer
_tokens Integer numbers.
- outputالنوع: integer
_tokens Integer numbers.
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/openai-websearch/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"input": "What are the three biggest AI announcements this week? Give one sentence each with sources.",
"max_output_tokens": 1024
}'
{
"id": "string",
"object": "response",
"status": "completed",
"output": [
{}
],
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"input_tokens_details": {
"cached_tokens": 1
}
}
}