Tavily Research

Usage-based pricing
ae_tavily_research

根据问题生成带来源的研究报告,支持模型、引用格式、报告长度、域名偏好、结构化输出和附件。本工具异步执行:先返回AE任务ID,再通过ae_get_result查询;查询同一任务不会重新提交研究。预占按所选模型官方上限,最终按实际用量结算。

Research
Usage-based pricing

Pricing

The charge per call is (max(6 × Actual research usage, 0)) AE credits. All applicable conditions are combined to calculate the total.

Charges vary with the selected research model and the task's actual research usage. Available models are mini, pro, and auto; the default is auto. Each research task is charged once upon completion. Repeated queries for the same task do not resubmit the research or incur additional charges. Zero actual usage incurs no charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
filesarrayNo研究使用的附件,包含文件名及base64内容;最多5个文件。—
files[].datastringYesThe base64-encoded file contents.—
files[].namestringYesThe filename, including its extension (`.txt`, `.md`, or `.json`).—
files[].typeenum (base64)NoThe encoding of the `data` field.base64
inputstringYes要研究的问题,尽量写明范围和输出要求。—
modelenum (mini | pro | auto)No研究模型:mini、pro或auto。auto
output_lengthenum (short | standard | long)No报告长度目标,不是严格字数上限。standard
output_schemaobjectNo研究结果的JSON Schema,需包含properties。—
output_schema.requiredarrayNoAn array of property names that are required. At least one key from the properties object must be included.—
output_schema.propertiesobjectNoAn object containing property definitions. Each key is a property name, and each value is a property schema.—
citation_formatenum (numbered | mla | apa | chicago)No研究报告的引用格式。numbered
exclude_domainsarrayNo排除的域名列表。[]
include_domainsarrayNo优先或限定检索的域名列表,具体约束取决于include_domains_mode。[]

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tavily_research' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "include_domains": [
      "docs.python.org"
    ],
    "input": "In at most 150 words, explain how Python asyncio.TaskGroup cancels sibling tasks when a child raises an exception. Cite the official Python documentation.",
    "model": "mini",
    "output_length": "short"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "c0e462fa-24bc-4a4e-a907-fe0224e1af35"
}

This example shows part of the response. Copied content is valid JSON.