Playground

在 控制台 → Playground 里,可以在浏览器中试用模型。这里使用你的 API Key,走的就是正式线上接口:成功请求会像 SDK 或 curl 调用一样扣费,并记入用量与日志。

Playground 不是免费试用环境。每次成功调用都会从预付费余额扣款。

开始之前

  1. 已注册并验证邮箱的 OctaRouter 账号,且账户有可用余额。余额不足可先 充值。
  2. 至少一把 API Key(控制台 → API Key)。
  3. 在 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
Defaultmodel-id
其他分组model-id:分组,例如 deepseek-v3.2:flex

只发布在非 Default 分组上的模型会自动带上对应后缀。选中分组后,协议列表也只保留该分组支持的协议。分组说明见 Flex 路由组。

协议与端点

在「参数设置」中依次选择 接入协议 和 请求端点。端点来自模型目录,并按当前分组支持的协议与所选模型类型筛选。切换模型、分组或协议后,会重新选择有效端点;目录明确没有可用端点时不能发送请求。旧版网关未提供端点字段时,沿用各协议的默认端点。

协议对话端点
OpenAIPOST /v1/responses、POST /v1/chat/completions
AnthropicPOST /v1/messages
GeminiPOST /v1beta/models/{model}:generateContent

只显示目录发布的端点,不是每个模型都支持上表中的所有端点。「参数设置」中的端点选择框下方显示当前请求路径,实际发送时使用对应端点的请求格式。Responses 支持多轮文本、图片输入和流式回复。

图像模型可选择生成或编辑端点;使用编辑端点时,先上传原始图片,再描述修改要求。转写和语音分别使用 /v1/audio/transcriptions 与 /v1/audio/speech。

运行之后怎么看费用

详细价格、分组优惠与计价规则请查看 模型 页。Playground 工作区专注于调试,不再重复展示价格说明;模型选择列表保留标准参考价,便于选择。

路由、用量阶梯和缓存命中可能影响费用。运行结束后,页面显示这次 实际扣费,保留 6 位小数;小于 $0.000001 的非零金额显示为 <$0.000001。同一笔也可以在 控制台 → 日志 里核对。

你取消了请求,或调用未能完成,通常 不会扣费。

如果提示余额不足,请先 充值 再试。

接入自己的应用时,用同一把 Key 调用上表中的接口即可,详见 API 协议。