api.foo
api.foo / 文档 / 常见问题(选之前看)

api.foo 常见问题:靠不靠谱、怎么充值、缓存怎么算、长任务会不会断

更新于 · 测试环境:macOS · curl 8.7.1(4 种接口写法和直连线路 2026-11-05 用测试密钥实测) · 作者:api.foo 文档组(怎么测试)
本页目录

一句话:api.foo 是独立运营的第三方大模型 API 服务,不是模型厂商官方。一个账号、一份人民币余额,用 https://api.foo 调 Claude、GPT、Gemini、Grok、DeepSeek、Kimi、智谱 GLM、MiniMax 等 80 多个模型(以模型广场为准),按量扣费,支持支付宝、微信、银行卡和 USDT。

开发者挑 API 中转站时,最常核对的是下面 8 件事。这页逐条写 api.foo 的实际情况,每一条都附上你自己能去核对的地方,不用只听我们说。想先了解 api.foo 是什么,看 api.foo 是什么。

8 件事一览

要核对的事 api.foo 的情况 自己去哪核对
是不是官方 不是。独立运营的第三方服务,发自己的密钥,和模型厂商没有隶属或合作关系 关于页底部的声明
接口格式 Anthropic Messages、OpenAI Chat Completions / Responses、Gemini 四种写法,域名都是 https://api.foo 下面「接口实测」一节
缓存计费 Claude 模型的缓存读取、缓存写入(5 分钟 / 1 小时)单独标价;其他厂商多数只有缓存读取价 每个模型的价格页,例如 claude-opus-5-5
流式和长任务 流式边收边转;长任务可以走不经 Cloudflare 的直连线路 https://dc.api.foo 下面「流式、长任务和超时」一节
报错怎么处理 返回 HTTP 状态码和错误原因(401、403、429、524 等),每种的意思和处理方法有专页 报错排查大全
计费明细 每次请求都记模型、输入 / 输出 / 缓存 token 数和扣了多少钱 控制台「使用日志」
隐私 api.foo 不保存提示词和模型回答,只记计费、排障用的信息 隐私政策
售后 公开服务条款;工单、邮箱、QQ 群、Telegram 群都能找到客服 本页最后「联系客服」

是不是官方,靠不靠谱

api.foo 不是 Anthropic、OpenAI、Google 的官方服务,和它们没有隶属或合作关系,文中提到的模型名称和商标归各自所有者。它是一个第三方 API 服务:你在 api.foo 注册、充值、创建密钥,请求经 api.foo 转发给上游模型服务,再把结果返回给你。

服务条款第四条写明:服务依赖上游、网络等条件,可能出现限流、变慢、短时不可用,不承诺持续无中断。用在生产环境,请自己设好重试、预算上限和备用方案。

「模型是不是真的」没法只靠一句保证,我们建议你自己验:

  1. 看日志:控制台「使用日志」里记的模型名和单价,就是你请求的那个模型,扣费也按它算。(返回 JSON 里的 model 字段由上游填写,可能带日期后缀。)
  2. 看缓存:Claude 模型开了提示缓存(Claude Code 默认开)以后,连续几次请求,使用日志里会出现「缓存读取」token 数,扣费也会明显变少。
  3. 看 token 数:发一句很短的话,返回里的 input_tokens 应该只有十几个;多出几百个,说明中间被加了看不见的提示词。更多自测方法见 API 中转站怎么选。
  4. 看效果:充 ¥5,拿你平时熟悉的任务跑几次,和你用过的版本比一比。

接口实测(2026-11-05)

四种写法的域名都是 https://api.foo,只是路径不同。2026-11-05 我们用一把测试密钥逐个请求(直连线路 https://dc.api.foo 也试了),服务器都回了 401 无效的令牌:说明地址和路径都对,请求已经到了 api.foo 的密钥验证这一步(不花钱)。请求内容对不对,要换上真密钥才算验过。

接口格式 请求地址 常见用法
Anthropic Messages POST https://api.foo/v1/messages Claude Code、anthropic SDK(软件里只填 https://api.foo)
OpenAI Chat Completions POST https://api.foo/v1/chat/completions openai SDK、Cherry Studio、Cline、OpenCode 等(地址填 https://api.foo/v1)
OpenAI Responses POST https://api.foo/v1/responses Codex、openai SDK 的 responses 接口(地址填 https://api.foo/v1)
Gemini POST https://api.foo/v1beta/models/<模型>:generateContent Gemini CLI、google-genai SDK(软件里只填 https://api.foo)

下面是 macOS / Linux 终端的写法(Windows 用 Git Bash 或 WSL),先把自己的密钥填进第一行:

export APIFOO_KEY="sk-你的密钥"
curl https://api.foo/v1/messages \
  -H "x-api-key: $APIFOO_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":64,"messages":[{"role":"user","content":"你好"}]}'

没设这个变量就运行,也会返回「401 无效的令牌」,和密钥填错一模一样。返回里有 "type":"text" 和一段回答,就说明通了。这把密钥的分组里要有你请求的模型(这里是 claude-sonnet-5-5,它在哪些分组能用,见它的模型页)。

Claude 模型支持 Anthropic 和 Chat Completions 两种格式,Gemini 模型支持 Gemini 和 Chat Completions 两种,其余多数是 Chat Completions;每个模型页下方的「调用示例」有现成的 curl。Codex 走 Responses 接口,配置见 Codex 教程。OpenAI 兼容的软件地址不带 /v1 也行,api.foo 会自动补上;但换到别家不一定兼容,按上表填最稳。各个软件怎么填,见 Claude Code、Codex、Gemini CLI、Cherry Studio 这些教程。

缓存怎么计费

用 Claude Code 这类编程工具时,大部分输入都是重复的上下文,缓存读取的单价往往比输入单价影响更大。

  • Claude 模型分三种缓存价:
    • 缓存读取:命中缓存的那部分输入。按 Anthropic 官方规则只要输入价的 2.5%~10%(看型号)。
    • 缓存写入(5 分钟):第一次把内容写进缓存时收,官方规则是输入价的 1.25 倍。
    • 缓存写入(1 小时):缓存保留更久,官方规则是输入价的 2 倍。
  • 其他厂商的模型(GPT、Gemini、DeepSeek 等)多数只有缓存读取价,以各自模型页为准。
  • 普通输入、输出照常计价。

具体单价在每个模型的价格页上(例如 claude-opus-5-5),不同分组价格不同。每次请求实际读了、写了多少缓存,控制台「使用日志」点开那条记录就能看到。

流式、长任务和超时

  • 流式输出:服务器收到上游一段就转一段,不攒着。
  • 默认线路 https://api.foo 经过 Cloudflare:非流式请求大约 120 秒还没返回,会被断开并报 524。改成流式输出一般就不会遇到。
  • 直连线路 https://dc.api.foo:不经过 Cloudflare,没有这个时间限制,适合长时间生成、大请求和生图。它只开放 /v1 和 /v1beta 接口,用浏览器打开是 404,这是正常的。把软件里的地址从 https://api.foo 换成 https://dc.api.foo 即可(原来带 /v1 的照样带),密钥不用换。
  • 流式中途断开:多半是上游出错或网络波动,重试即可;反复出现,把报错里的 request id 发给客服查。

报错了怎么处理

api.foo 出错时会返回 HTTP 状态码和错误原因,最常见的几种:

状态码 / 报错 一般是什么原因 怎么办
401 无效的令牌 密钥错了或少了字、没带密钥(变量是空的),或者这把密钥已过期、被禁用、自己的额度上限用完了 到控制台「API 密钥」看这把密钥的状态和剩余额度
403 用户额度不足 账户余额不够 到「钱包」充值,或者调小 max_tokens
403 无权访问模型、IP 不在列表 密钥设了模型限制或 IP 白名单 编辑密钥,放开限制
无可用渠道、模型价格未配置 模型名和模型广场上的不完全一样(含大小写),或者这把密钥的分组里没有这个模型 到模型页复制模型名;换一把建在对的分组里的密钥
404 Invalid URL 路径写错,比如写成了 /v1/chat/completion(少了个 s) 对照上面「接口实测」表里的路径
429 请求太快,或者上游限流 降低并发,等一会儿再试,每次等得更久一点
5xx 上游临时出错 过几十秒重试;一直出错就把 request id 发给客服
524 默认线路的非流式请求超过约 120 秒 打开流式输出,或者换成 https://dc.api.foo

每种报错长什么样、怎么一步步排查,见 报错排查大全。登录后点左边栏「渠道状态」,能看到各个分组最近的测试结果:你这把密钥所在的分组标红,多半是那边上游的问题,不是你的配置。

计费、充值、退款和发票

  • 怎么收钱:人民币预付,按实际用量扣费(生图按张),没有月费。不开发票时充多少到账多少,¥5 起充。
  • 付款方式:支付宝、微信、银行卡、USDT(¥40 起;只收 BSC / BEP20 网络,到账数量要和应付金额完全一致,转账手续费另加,转错网络无法到账也退不回)。
  • 密钥按分组创建:同一份余额可以用所有模型,但一把密钥属于一个分组,不同模型可能要用不同分组的密钥。每个模型能在哪些分组用,模型广场里能查。
  • 退款:因配置错误、误调用、密钥泄露或超出预算产生的正常消耗,不支持无条件退款;重复扣款、付了钱没到账、平台确认的计费异常,客服核查后按原支付方式退款或补发余额(见服务条款第三条)。
  • 发票:单笔充值满 ¥300 可以开增值税普通发票(公司或个人抬头,内容为「技术服务费」)。开票按充值额扣一定比例:¥300–1999 扣 5%,¥2000–4999 扣 4%,¥5000 及以上扣 3%(例如充 ¥500 到账 ¥475)。充值后提交工单,附上订单号和抬头,1 个工作日内开好。

隐私和数据

按 隐私政策:

  • api.foo 不保存对话内容:提示词、上下文、附件和模型返回的内容只在转发时经过服务器,不写入数据库或日志。
  • 只记计费、排障用的信息:时间、模型名称、所用密钥的名称、输入和输出 token 数、费用、耗时、来源 IP。
  • 例外:视频、音乐这类排队生成的异步任务,会保存提示词和结果链接,方便你之后查进度、取结果。
  • 请求会转发给上游模型服务,上游是否保存请求,由上游自己的政策决定。身份证号、密码、密钥、商业机密这类内容,不建议放进提示词。

先花 5 块钱自测

  1. 注册账号,在控制台「钱包」充 ¥5。
  2. 在控制台「API 密钥」里建一把密钥:分组选有你要用的模型的那个(模型页上写着每个模型在哪些分组),再给它设一个额度上限,防止用超。额度用完会报「401 无效的令牌」,到控制台调高额度即可。
  3. 用上面的 curl 发一次请求,再在你常用的软件里跑一个平时的任务。
  4. 打开控制台「使用日志」,看模型名、token 数和扣费对不对得上。上面那条 curl 太短,用不到缓存;想看缓存,用 Claude Code 连发两条消息,第二条的「缓存读取」应该有几千 token。
  5. 有长任务的,再把地址换成 https://dc.api.foo 试一次。

联系客服

  • 控制台「我的工单」(直接提交):账号、充值、发票、退款都可以在这里提交。
  • 邮箱:[email protected]
  • QQ 群 639791134、Telegram 群 t.me/api_foo
  • 在线时间:每天 9:00–23:00(北京时间)。问调用出错的事,附上报错里的 request id,查得最快。

相关阅读

常见问题

api.foo 是 Anthropic、OpenAI 或 Google 官方的 API 吗?

不是。api.foo 是独立运营的第三方大模型 API 服务,和 Anthropic、OpenAI、Google、xAI 等模型厂商没有隶属或合作关系,文中提到的模型名称和商标归各自所有者。它发自己的 API 密钥,你的请求经 api.foo 转发给上游模型服务,按人民币计费。

api.foo 支持哪些接口格式,能接 Claude Code 吗?

支持 Anthropic Messages(/v1/messages)、OpenAI Chat Completions(/v1/chat/completions)、OpenAI Responses(/v1/responses)和 Gemini(/v1beta)四种写法,域名都是 https://api.foo。Claude Code、Gemini CLI 只填域名 https://api.foo;Codex 和 OpenAI 格式的软件填 https://api.foo/v1。Claude 模型支持 Anthropic 和 Chat Completions 两种,Gemini 模型支持 Gemini 和 Chat Completions 两种,其余多数是 Chat Completions;Codex 走 Responses 接口,配置见 Codex 教程。

api.foo 怎么充值,最低充多少?

人民币预付、按量扣费,没有月费。支付宝、微信、银行卡 ¥5 起充,USDT(BSC 链)¥40 起。余额所有模型通用,但 API 密钥按分组创建,要用哪个模型,就把密钥建在有这个模型的分组里。

Claude 的提示缓存在 api.foo 怎么计费?

Claude 模型分三种单价:缓存读取(命中)、缓存写入(5 分钟)、缓存写入(1 小时),和普通输入、输出分开算。按 Anthropic 官方规则,5 分钟写入是输入价的 1.25 倍、1 小时写入是 2 倍,读取只要输入价的 2.5%~10%。每个模型的单价写在它的价格页上;控制台「使用日志」里能看到每次请求读了、写了多少缓存。

长任务超时(524)、流式中途断开怎么办?

默认线路 https://api.foo 经过 Cloudflare,非流式请求大约 120 秒还没返回会被断开(报 524)。长任务改用流式输出,或者把地址换成直连线路 https://dc.api.foo,它不经过 Cloudflare,没有这个时间限制,只开放 API 接口。流式中途断开多半是上游出错或网络波动,重试即可;反复出现就把报错里的 request id 发给客服。

api.foo 能退款、能开发票吗?

因配置错误、误调用、密钥泄露或超出预算产生的正常消耗,不支持无条件退款;重复扣款、付了钱没到账、平台确认的计费异常,客服核查后按原支付方式退款或补发余额。单笔充值满 ¥300 可以开增值税普通发票,开票按充值额扣 3%~5%,在控制台「我的工单」申请。

api.foo 会保存我的提示词和代码吗?

按隐私政策,api.foo 不保存。提示词、上下文、附件和模型返回的内容只在转发时经过服务器,不写入数据库或日志;只记录时间、模型、密钥名称、token 数、费用、耗时和来源 IP 这些计费、排障用的信息。排队生成的视频、音乐等异步任务例外。请求会转发给上游模型服务,上游是否保存,由上游自己的政策决定。

发现内容有误?发邮件到 [email protected] 告诉我们。