
端点栏
面板上方的横条显示当前配置实际请求的端点,例如POST https://api.aisa.one/v1/chat/completions,右侧的 stream: true / stream: false 标签与 Stream 开关保持同步。
切换 Route 时,端点会随之变化。
请求面板
左侧面板用于定义请求。
Key
Key 选择器决定使用哪个 API key 认证请求。列表只包含已启用的 key,每一项显示 key 名称以及脱敏后的前后缀。 完整 key 不会下发到浏览器,请求在后端签名。用量会记在所选 key 上,因此可以用一个专用 key 把 Playground 流量与应用流量区分开。 如果还没有已启用的 key,请先在 API Keys 页面创建一个。Route
Route 选择器决定请求使用哪套 API:- Chat completions —
POST /v1/chat/completions,OpenAI 兼容路由。System 提示词会作为messages中的system消息发送。 - Messages —
POST /v1/messages,Anthropic 兼容路由。System 提示词会作为顶层system字段发送。
Model
Model 选择器列出所选 key 在当前路由下可用的全部模型。选择器下方的计数显示已加载的模型数量,刷新按钮可以重新拉取列表。 切换模型不需要改动请求格式,只有model 标识符会变化。
如果账户仍在试用额度状态,而所选模型要求付费余额,Playground 会显示充值提示并禁用 Run Test。此时可以换一个模型,或先充值。
生成参数
Stream
Stream 控制响应是否以 server-sent events 增量返回。开启后,输出会在 Output 面板逐 token 出现,请求体中会包含"stream": true。
Temperature
Temperature 是可选参数:旁边的开关决定请求中是否包含temperature。开关关闭时该参数会被省略,使用模型自身的默认值。
开启后,较低的值输出更确定,较高的值变化更多。取值范围为 0–2。
Max Tokens
Max tokens 设置生成 token 的上限,用于控制响应长度和成本。该参数始终包含在请求中。System 与 User
System 字段用于约束模型行为,User 字段则是提示词本身。两者都是纯文本输入框,编辑时请求预览会实时更新。 点击 Run Test 发送请求。请求进行中按钮会变为 Stop,点击即可立刻中断连接。Debug 面板
右侧面板在运行之前就能看到 AIsa 将要发送的确切内容。
- JSON — 将要提交的请求体,带行号
- cURL — 同一个请求的终端命令形式,使用
$AISA_API_KEY,可直接复制粘贴
生成的命令用单引号包裹 JSON 请求体。如果 System 或 User 提示词中包含单引号(
'),需要先转义再在 shell 中执行,否则请求体会被截断。输出面板
请求预览下方是 Output 面板。- Result — 提取出的助手文本,开启 Stream 时实时流式显示
- Response — 响应 payload:非流式请求为完整 JSON 响应体;流式请求则按行显示每个 SSE 事件的
data内容(data:前缀和其他事件字段会被去掉)
x-request-id,以及本次调用是否为流式。排查问题时可以用这个 request ID 去 Usage Logs 页面对照,或提供给支持人员。
错误会内联显示,原始错误内容可在 Response 标签中查看。
用量与计费
Playground 的所有请求都与普通 API 请求一样计入用量和账单,并会以所选 key 的名义出现在日志和用量图表中。Playground 最适合用来做什么
- 不改代码就能比较不同模型的输出
- 确认某个 key 能否访问指定模型
- 在写集成代码前验证请求体
- 复制一条可用的 cURL 命令作为起点
- 在同一个界面里结合原始响应和 request ID 排查错误
相关页面
聊天补全 API
在这里验证后,用代码发送相同请求。
身份认证
创建并管理 Playground 使用的 API key。
模型目录
浏览当前模型 ID、上下文窗口、endpoint、能力和计费说明。