STapi API 接入快速开始

1. 为当前设备创建独立密钥#

登录中转站后，可按设备、成员或用途分别创建 API Key。独立密钥便于统计用量，也便于在异常情况下单独撤销。

建议按用途命名，例如：

• personal-mac
• windows-test
• team-member-a
• automation-readonly

密钥创建后应保存在密码管理器等安全位置。公开文档和截图中可使用 sk-your-key 作为占位符，避免出现真实值。

2. 确认接口地址与模型#

OpenAI 兼容客户端通常需要两个参数：

1
Base URL: https://api.monetlabs.art/v1
2
API Key:  sk-your-key

模型参数需要使用中转站当前提供的模型标识，可从管理页面或模型列表中确认。

3. 查询可用模型#

可先通过终端环境变量临时提供密钥，减少密钥被写入项目文件的风险。需要注意，直接输入的赋值命令仍可能保存在终端历史中，因此不应在共享设备或录屏环境中操作。

1
$env:STAPI_API_KEY = "sk-your-key"

1
export STAPI_API_KEY="sk-your-key"

使用当前密钥查询模型列表：

1
Invoke-RestMethod `
2
  -Uri "https://api.monetlabs.art/v1/models" `
3
  -Headers @{ Authorization = "Bearer $env:STAPI_API_KEY" }

1
curl https://api.monetlabs.art/v1/models \
2
  -H "Authorization: Bearer $STAPI_API_KEY"

请求成功时会返回该密钥当前可访问的模型。后续请求中的 model 参数应采用列表中的模型标识，而不是根据展示名称推测。

4. 发送基础请求#

以下请求用于验证聊天补全端点。your-model-id 需要替换为模型列表中实际返回的标识。

1
$headers = @{ Authorization = "Bearer $env:STAPI_API_KEY" }
2
$body = @{
3
  model = "your-model-id"
4
  messages = @(
5
    @{ role = "user"; content = "只回复 OK" }
6
  )
7
} | ConvertTo-Json -Depth 4
8

9
Invoke-RestMethod `
10
  -Uri "https://api.monetlabs.art/v1/chat/completions" `
11
  -Method Post `
12
  -Headers $headers `
13
  -ContentType "application/json" `
14
  -Body $body

1
curl https://api.monetlabs.art/v1/chat/completions \
2
  -H "Authorization: Bearer $STAPI_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{
5
    "model": "your-model-id",
6
    "messages": [{"role": "user", "content": "只回复 OK"}]
7
  }'

5. 配置实际客户端#

基础请求通过后，可将相同的 Base URL、API Key 和模型标识填入兼容客户端。分阶段验证有助于区分接口连接问题和客户端配置问题。

常见错误的排查顺序#

验证结果#

若模型列表、基础请求和实际客户端均能正常返回，且密钥未写入项目文件、控制台中可以识别其用途，则基本接入配置已经生效。