Web Fetch

把你已有 URL 的頁面全文交給模型。加一個工具條目,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 }
}

計費