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
仅支持 minimal effort；省略、空值和 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 余额、冻结金额或账单凭证。
- 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
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
操作失败。联系 Felo 支持时请保留响应的请求 ID。
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"
}