在 控制台 → Playground 里,可以在浏览器中试用模型。这里使用你的 API Key,走的就是正式线上接口:成功请求会像 SDK 或 curl 调用一样扣费,并记入用量与日志。
Playground 不是免费试用环境。每次成功调用都会从预付费余额扣款。
开始之前
- 已注册并验证邮箱的 OctaRouter 账号,且账户有可用余额。余额不足可先 充值。
- 至少一把 API Key(控制台 → API Key)。
- 在 Playground 中选择模型,或从 模型 页点击 在 Playground 试用。
模型类型
按你要做的事选择类型。不同模型的计费方式可能不同,可在 模型 页查看详细计价规则,运行后核对实际扣费。
| 类型 | 接口 | 怎么计费 |
|---|---|---|
| 对话 | Responses、Chat Completions、Anthropic Messages 或 Gemini Generate Content | 按 Token(输入 / 输出;部分模型另计缓存或推理 Token) |
| 图像 | POST /v1/images/generations 或 POST /v1/images/edits | 按图像 Token,或按张(每次生成 1 张) |
| 转写 | POST https://api.octarouter.com/v1/audio/transcriptions | 按音频时长(秒),或按音频 Token |
| 语音 | POST https://api.octarouter.com/v1/audio/speech | 按实际合成的字符数,不按输入框字数估算 |
能理解图片的对话模型仍走 对话,并按 Token 计费。它们不是「生成图片」的模型。
路由分组
同一模型可能发布多个路由分组(例如 Default 与 Flex)。Playground 在模型名称旁提供分组切换:
| 分组 | 请求里的模型 ID |
|---|---|
| Default | model-id |
| 其他分组 | model-id:分组,例如 deepseek-v3.2:flex |
只发布在非 Default 分组上的模型会自动带上对应后缀。选中分组后,协议列表也只保留该分组支持的协议。分组说明见 Flex 路由组。
协议与端点
在「参数设置」中依次选择 接入协议 和 请求端点。端点来自模型目录,并按当前分组支持的协议与所选模型类型筛选。切换模型、分组或协议后,会重新选择有效端点;目录明确没有可用端点时不能发送请求。旧版网关未提供端点字段时,沿用各协议的默认端点。
| 协议 | 对话端点 |
|---|---|
| OpenAI | POST /v1/responses、POST /v1/chat/completions |
| Anthropic | POST /v1/messages |
| Gemini | POST /v1beta/models/{model}:generateContent |
只显示目录发布的端点,不是每个模型都支持上表中的所有端点。「参数设置」中的端点选择框下方显示当前请求路径,实际发送时使用对应端点的请求格式。Responses 支持多轮文本、图片输入和流式回复。
图像模型可选择生成或编辑端点;使用编辑端点时,先上传原始图片,再描述修改要求。转写和语音分别使用 /v1/audio/transcriptions 与 /v1/audio/speech。
运行之后怎么看费用
详细价格、分组优惠与计价规则请查看 模型 页。Playground 工作区专注于调试,不再重复展示价格说明;模型选择列表保留标准参考价,便于选择。
路由、用量阶梯和缓存命中可能影响费用。运行结束后,页面显示这次 实际扣费,保留 6 位小数;小于 $0.000001 的非零金额显示为 <$0.000001。同一笔也可以在 控制台 → 日志 里核对。
你取消了请求,或调用未能完成,通常 不会扣费。
如果提示余额不足,请先 充值 再试。
接入自己的应用时,用同一把 Key 调用上表中的接口即可,详见 API 协议。