# Playground

[Playground](https://stack.foldbun.com/playground/) 可在浏览器中运行全部模型。每个模型都有记录好的示例，打开即可查看，也可上传图片运行真实推理。结果旁显示计时、费用、原始 JSON，以及 curl 和 Python 的"复制为代码"片段，其中密钥以占位符 `$FOLDBUN_API_KEY` 表示。

Playground 是独立的网页客户端，使用自己的接口，这些接口不属于公共 API。集成应使用 API 密钥调用 `/v1`。详见[快速开始](https://stack.foldbun.com/zh/docs/quickstart/)。

## 试用通道

试用通道面向任何人，无需账户，提供全部 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 密钥，浏览器中也不存在密钥。

## 相关页面

- [速率限制与模型池](https://stack.foldbun.com/zh/docs/rate-limits/)
- [计费](https://stack.foldbun.com/zh/docs/billing/)