用 AI 探索 WeaveBit，接入 API

可以让 AI 结合 WeaveBit 官方资料，帮你比较检测方式、选择入口并估算预算；准备接入时，也可按你的编程语言和运行环境提供 API 接入步骤与示例代码。先明确需求，再从小规模试用开始。阅读资料和生成代码不会自动创建检测任务或产生检测费用。

WeaveBit 能解决什么问题

WeaveBit 帮助网站运营者、运维团队和服务提供商了解域名在中国大陆的网络访问情况，适合网站上线检查、访问异常排查、多域名巡检和持续监控。

检测反映特定方法、网络与时间的观测，不保证网站在所有地区、所有时刻都可访问。它不能代替完整浏览器、应用功能或源站诊断，也不能仅凭一次异常确定故障责任方。

先查 DNS 污染，还是做 GFW 全量检测

DNS 污染检测通常是检查中国访问性的首要步骤，输入域名即可，无需选择节点。普通 DNS 解析成功不等同于没有 DNS 污染。

需要更完整、便捷的批量检查时，选择 GFW 全量检测。它结合 DNS 污染、HTTP Host 和 TLS SNI 三个维度，并按目标客户的地区、运营商选择节点；“全量”不是把七种检测全部执行，也不代表完整浏览器测试。详见检测能力。

选择免费网页、Console 或 API

免费网页不是自动化接口。Console 单任务最多 200 个域名；API v2 单批最多 1,000 个目标。

价格与计费单位

Console 与 API 共用账户余额，但使用各自的单价。以下为美元单价：

DNS 污染检测没有额外的节点乘数，GFW 全量检测包含节点乘数。按有效结果结算，具体费用以价格页面、费用预估和实际计费为准。

怎样规划检测预算

例如，计划检查 10 个域名，每小时一次，即每天 24 轮。DNS 污染的每日预算为“10 × 24 × 对应入口的 DNS 单价”；若 GFW 全量选择 3 个节点，则为“10 × 3 × 24 × 对应入口的 GFW 单价”。按计划天数可继续估算月度用量。

先选与用户有关的节点和必要频率，不必一开始覆盖所有节点。使用费用计算器规划；API 创建前以相同参数调用 /task/estimate，目标或节点变动后重新预估，并设置自己的预算上限。

从试用额度开始

每位新用户注册后，系统自动赠送 US$0.20 检测试用额度，无需联系客服。说明检测需求并联系客服，还可获得 US$3 人工试用额度；两种额度互不冲突。

登录 Console 查看余额，先用少量目标试用，再决定检测范围和频率。试用额度用于检测试用，不代表无限量免费。申请方式见价格与试用说明。

怎样理解正常、异常与无法判定

场景判定值 0 表示本次未报告对应异常，1 表示报告明确异常，null 表示无法判定。无法判定不等于正常或封锁，也不能作为恢复依据；应结合网络、时间和复测分析。

API 的 completed 只表示执行结束，不代表目标正常。不要把单次观测扩大为“中国所有地区不可访问”；详细说明见结果解读。

让 AI 协助产品评估与 API 接入

正在选型时，告诉 AI 你的目标数量、用户地区、期望频率、预算，以及是否需要平台告警或接入自有系统，让它结合官方资料目录和本页说明比较方案。准备接入时，再说明编程语言、版本和运行环境，让 AI 阅读 API 文档与 SDK 示例，提供相应步骤和代码。

1. 选择接入方式：根据场景区分 API v1 同步单域名 DNS 污染检测与 API v2 异步批次，选择适合的 SDK 或 HTTP 请求方式，不要混用两版参数。
2. 准备认证与费用预估：示例使用 YOUR_API_KEY 等占位符或服务器环境变量 WEAVEBIT_API_KEY。按检测方式准备目标与节点参数；DNS 污染请求不传 nodes。API v2 创建前先以相同参数估价。
3. 组织创建与结果读取：为 API v2 创建请求保存原请求与幂等键，受理后保存 batch_id；查询执行进度并读取全部结果分页。区分 HTTP、业务错误与检测结果，按文档处理超时、有限重试和 Retry-After。

阅读资料和编写代码不需要提供真实 API Key，不要把密钥放入聊天或公开提示词。示例应明确标出可能收费的创建步骤；实际执行前，确认目标权限、检测范围、执行频率和预算并取得明确授权。这里的复制功能不会代为登录账户或执行付费检测。

API v2 最长执行 6 小时，结果在创建后 24 小时清理，需及时保存。参数、错误码、运行要求和 SDK 方法以对应官方文档为准。

供 AI 阅读的更多资料：文档首页 · 结果解读 · API 文档 · SDK 示例。