我们怎么测试:api.foo 文档的实测方法、价格来源和更新规则
本页目录
一句话:api.foo 文档里的安装步骤、配置写法和报错原文都先实测再写。软件装在隔离环境里,用不能扣费的假密钥连官方接口和 api.foo,记录真实返回;价格只写官方公布的,并注明日期。
怎么测试
- 隔离环境:软件装在临时目录、用临时的用户目录运行(比如 Claude Code 用单独的配置目录),不碰任何真实配置。
- 假密钥:用格式正确、但不能扣费的假密钥(如
sk-thisisafakekeyfortesting)分别连接官方接口和 api.foo,记下状态码和报错原文。服务器返回「无效的令牌」「invalid x-api-key」这类结果,说明地址、格式和鉴权方式都写对了,只是密钥不对。这样不花钱,也不碰任何人的账号。 - 看软件实际发了什么:在本机起一个只记录请求的假服务器,让软件连它,看它真实请求的地址、请求头和模型名。比如 Claude Code 默认请求哪个模型、地址后面会不会自己拼
/v1,都是这样确认的。 - 写清测试环境:每篇教程开头写「测试环境」(系统、软件版本)和「更新于」日期。软件升级后写法可能变,以文中注明的版本为准。
- 没测到的如实写:比如某个官方地址在国内能不能直连、某个功能只对部分账号开放,没测到就写「没测到」或「官方没说明」,不猜。
价格从哪里来
- 只写模型厂商官方公布的价格。写作时抓取官方价格页存档,文中注明「按 2026 年 10 月官方价格」这样的时间。
- 算例(比如「一个任务大概花多少钱」)用脚本复核过。
- api.foo 自己的价格不写进文章,统一以 模型广场 实时显示的为准。
更新规则
- 官方改价、软件大版本更新、报错原文变化时,会重新测试并修改,同时更新文章开头的日期。
- 文章里提到的官方网址会定期检查能不能打开,搬家了就换成新地址。
利益关系说明
- 这些文档由 api.foo 编写。api.foo 是独立运营的第三方 API 服务(介绍见 api.foo 是什么),和 Anthropic、OpenAI、Google 等模型厂商没有隶属或合作关系。
- 教程会写怎么接 api.foo,也会写官方途径怎么用;比较其他服务时只用对方公开的资料。
- 不写绕过地区限制的方法,不冒称「官方授权」。
发现错误
发邮件到 [email protected],写上文章地址和哪里不对。核实后会修改,并更新「更新于」日期。
相关阅读
常见问题
文档里的配置写法是真的测过的吗?
是。每篇教程写之前,都会把软件装在隔离的临时环境里,按文中的写法配置,用不能扣费的假密钥连接官方接口和 api.foo,确认请求真的发到了正确的地址、拿到了预期的返回(比如「无效的令牌」),再把测试环境和软件版本写在文章开头。
用假密钥能证明什么?
能证明地址、请求格式和鉴权方式写对了:请求到达了服务器,服务器认出了格式,只是因为密钥不对才拒绝。这样不花钱、也不碰任何真实账号;文中引用的报错原文就是这样拿到的。
文章里的价格从哪里来?
只写模型厂商官方公布的价格,写作时抓取官方价格页存档,并在文中注明是几月的价格。api.foo 自己的价格不写进文章,统一以模型广场实时显示的为准。
发现文章有错怎么办?
发邮件到 [email protected],写上文章地址和哪里不对。核实后会修改,并更新文章开头的「更新于」日期。
发现内容有误?发邮件到 [email protected] 告诉我们。