Playground
Playground 可在浏览器中运行全部模型。每个模型都有记录好的示例,打开即可查看,也可上传图片运行真实推理。结果旁显示计时、费用、原始 JSON,以及 curl 和 Python 的“复制为代码”片段,其中密钥以占位符 $FOLDBUN_API_KEY 表示。
Playground 是独立的网页客户端,使用自己的接口,这些接口不属于公共 API。集成应使用 API 密钥调用 /v1。详见快速开始。
试用通道面向任何人,无需账户,提供全部 7 个模型。
- 匿名。 无需登录,也无需密钥。
- 自动人机验证。 每次提交都会通过自动人机验证(Cloudflare Turnstile)。验证可以是无感的,也可以是交互式的。
- 最低优先级。 试用任务排在 API 流量之后,模型繁忙时最先被拒绝。每个模型同一时刻只运行一个试用任务;Playground 会显示前面还有多少个试用请求,以及等待所用的时间。
- 不收费。 试用调用不产生费用。响应中的
cost为 0,并给出该调用按价目表折合的额度。 - 容量有限。 模型的队列已满或当日试用预算用尽时,调用会以
503 trial_busy拒绝,该错误可重试。
一次验证,多次调用
Section titled “一次验证,多次调用”有些演示每次提交需要多次 API 调用。一次人机验证通过后,一个短期有效的试用授权会覆盖该次提交的后续调用,无需再次验证。
| 模型 | 一个授权覆盖的范围(10 分钟内) |
|---|---|
sam3、sam-lite |
最多 10 次 segment 调用和 100 次 refine 调用,限于首次调用的那张图片 |
dinov3 |
最多 4 次图片调用 |
siglip2 |
最多 2 次调用:一张图片和一组文本 |
ppocr-v6、paddleocr-vl、birefnet |
1 次调用 |
授权过期或用完后,调用会以 403 trial_grant_invalid 拒绝,Playground 会要求重新验证。
试用输入限制
Section titled “试用输入限制”- 图片以 base64 发送,解码后最大 8 MiB。对于 SAM 的后续调用,也接受授权所绑定图片的
img_句柄。 sam3:每次调用最多 5 个文本提示,提示总数最多 10 个。siglip2:每次调用最多 16 条文本。- 试用调用按 IP 地址限制为每分钟 20 次,突发 10 次。这只用于阻止脚本。
- 试用通道的图片在 1 小时后删除。
已登录且邮箱已验证的账户,可以使用自己的额度运行 Playground。规则与 /v1 相同:模型池、限制、计费、幂等性。用量在控制台中显示为 “Playground”。无需 API 密钥,浏览器中也不存在密钥。