跳转到内容
Foldbun Stack文档
EN获取 API 密钥即将推出

Playground 可在浏览器中运行全部模型。每个模型都有记录好的示例,打开即可查看,也可上传图片运行真实推理。结果旁显示计时、费用、原始 JSON,以及 curl 和 Python 的“复制为代码”片段,其中密钥以占位符 $FOLDBUN_API_KEY 表示。

Playground 是独立的网页客户端,使用自己的接口,这些接口不属于公共 API。集成应使用 API 密钥调用 /v1。详见快速开始。

试用通道面向任何人,无需账户,提供全部 7 个模型。

  • 匿名。 无需登录,也无需密钥。
  • 自动人机验证。 每次提交都会通过自动人机验证(Cloudflare Turnstile)。验证可以是无感的,也可以是交互式的。
  • 最低优先级。 试用任务排在 API 流量之后,模型繁忙时最先被拒绝。每个模型同一时刻只运行一个试用任务;Playground 会显示前面还有多少个试用请求,以及等待所用的时间。
  • 不收费。 试用调用不产生费用。响应中的 cost 为 0,并给出该调用按价目表折合的额度。
  • 容量有限。 模型的队列已满或当日试用预算用尽时,调用会以 503 trial_busy 拒绝,该错误可重试。

有些演示每次提交需要多次 API 调用。一次人机验证通过后,一个短期有效的试用授权会覆盖该次提交的后续调用,无需再次验证。

模型 一个授权覆盖的范围(10 分钟内)
sam3、sam-lite 最多 10 次 segment 调用和 100 次 refine 调用,限于首次调用的那张图片
dinov3 最多 4 次图片调用
siglip2 最多 2 次调用:一张图片和一组文本
ppocr-v6、paddleocr-vl、birefnet 1 次调用

授权过期或用完后,调用会以 403 trial_grant_invalid 拒绝,Playground 会要求重新验证。

  • 图片以 base64 发送,解码后最大 8 MiB。对于 SAM 的后续调用,也接受授权所绑定图片的 img_ 句柄。
  • sam3:每次调用最多 5 个文本提示,提示总数最多 10 个。
  • siglip2:每次调用最多 16 条文本。
  • 试用调用按 IP 地址限制为每分钟 20 次,突发 10 次。这只用于阻止脚本。
  • 试用通道的图片在 1 小时后删除。

已登录且邮箱已验证的账户,可以使用自己的额度运行 Playground。规则与 /v1 相同:模型池、限制、计费、幂等性。用量在控制台中显示为 “Playground”。无需 API 密钥,浏览器中也不存在密钥。