Exa
Semantic search, page content, cited answers and asynchronous research.
إرسال تشغيل Agent بحث غير متزامن.
أرسل مهمة بحث غير متزامنة. وفّر query؛ واختياريًا systemPrompt وeffort (بالقيمة minimal فقط). الحقل Idempotency-Key مطلوب. يعيد HTTP 202 مهمة؛ استخدم id الخاص بها مع نقطة نهاية الاستطلاع المقابلة في Felo حتى تصبح completed أو failed أو cancelled. حقول تسعير المهمة هي تفويض المزوّد وبيانات التسوية الوصفية، وليست سجلات فوترة Felo.
مرجع التسعير
- القياس: مرجع لكل طلب.
- تقدير الطلب المرجعي: 0.1 دولار أمريكي.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringIdempotency
- Key مطلوبيجب أن يكون طول UTF-8 بعد التشذيب من 1 إلى 191 بايت.
- النوع: stringqueryمطلوب
استعلام غير فارغ بعد إزالة المسافات.
- النوع: string | null تعدادeffort
يُدعم effort من نوع minimal فقط؛ وتُطبَّع القيم المحذوفة والفارغة وnull إلى minimal.
القيم- null
- minimal
- النوع: string | nullsystem
Prompt
- النوع: object202
نجاح
- النوع: string | null التنسيق: date-timecompleted
At مطلوبthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- النوع: string | null التنسيق: date-timecreated
At مطلوبthe date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- النوع: string | nullendpointمطلوب
معرّف عملية المزوّد؛ استخدم مسار وظيفة Felo الموثّق للاستعلام الدوري.
- النوع: object | nullerrorمطلوب
- codeالنوع: string | null
- messageالنوع: string | null
- النوع: string | nullidمطلوب
- objectثابت:integration_async_jobمطلوب
- outputمطلوب
- النوع: object | nullpricingمطلوب
بيانات وصفية لتفويض المزوّد وتسويته بالميكرو دولار؛ وليست رصيد Felo أو حجزًا أو إيصال فوترة من Felo.
- authorizedالنوع: integer | null
Micros U S D Integer numbers.
- billingالنوع: string | null
Mode - currencyالنوع: string | null
- finalالنوع: integer | null
Micros U S D Integer numbers.
- النوع: string تعدادstatusمطلوبالقيم
- queued
- running
- completed
- failed
- cancelled
- النوع: boolean | nulloutput
Expired
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
فشلت العملية. احتفظ بمعرّف طلب الاستجابة عند التواصل مع دعم Felo.
curl https://openapi.felo.ai/v1/beta/exa/agent/runs \
--request POST \
--header 'Idempotency-Key: ' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"query": "Find the official documentation for Go"
}'
{
"completedAt": null,
"createdAt": null,
"endpoint": null,
"error": {
"code": null,
"message": null
},
"id": null,
"object": "integration_async_job",
"output": null,
"outputExpired": null,
"pricing": {
"authorizedMicrosUSD": null,
"billingMode": null,
"currency": null,
"finalMicrosUSD": null
},
"status": "queued"
}