Web Fetch

把你已经知道 URL 的那个网页,整篇正文交给模型。加一个 tool 条目,Synthorai 负责抓取、清洗,把可读正文放进对话 —— 任意模型、任意渠道都能用。

最小请求

在 /v1/messages 的 tools 里加上 synthorai:web_fetch,其余照旧:

curl https://synthorai.io/v1/messages \
  -H "x-api-key: $YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "tools": [{"type": "synthorai:web_fetch"}],
    "messages": [
      {"role": "user", "content": "Summarise https://docs.anthropic.com/en/docs/build-with-claude/tool-use"}
    ]
  }'

可选参数

synthorai:web_fetch 条目上的所有字段都可选:

{
  "type": "synthorai:web_fetch",
  "max_uses": 2
}

与 Web Search 搭配

搜索负责找到页面,抓取负责读完它。两个都声明,模型就能先搜、挑一条靠谱的结果、再把整页读进来 —— 研究类问题通常需要的正是这个:

"tools": [
  {"type": "synthorai:web_search"},
  {"type": "synthorai:web_fetch"}
]

响应结构

每次抓取在 assistant 轮里表现为一对块,后面跟模型的回答:

{
  "type": "server_tool_use",
  "id": "srvtoolu_synth_...",
  "name": "web_fetch",
  "input": { "url": "https://example.com/page" }
},
{
  "type": "web_fetch_tool_result",
  "tool_use_id": "srvtoolu_synth_...",
  "content": {
    "type": "web_fetch_result",
    "url": "https://example.com/page",
    "title": "Example page",
    "content": { "type": "text", "text": "…page body…" }
  }
}

抓取次数会记在 usage 里,你可以自己对账:

"usage": {
  "input_tokens": 9241,
  "output_tokens": 412,
  "cache_read_input_tokens": 0,
  "cache_creation_input_tokens": 0,
  "server_tool_use": { "web_fetch_requests": 1 }
}

计费