跳转到主要内容
POST
/
api
/
v1
/
GetUsageConfig
获取使用配置
curl --request POST \
  --url https://server.codeium.com/api/v1/GetUsageConfig \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_key": "<string>",
  "team_level": true,
  "group_id": "<string>",
  "user_email": "<string>"
}
'
{
  "addOnCreditCap": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概览

获取你所在组织当前的每用户附加额度上限配置。额度上限始终以单个用户为单位设定。当你按团队或群组范围进行查询时，响应会返回应用于该团队或群组内用户的每用户额度上限。

​
请求

​
service_key
string
必填
具备 Billing Read 权限的服务密钥

​
作用域配置（任选其一）

​
team_level
boolean
设为 true 以获取应用于团队内所有用户的每用户上限
​
group_id
string
通过提供组 ID 来获取应用于指定组内所有用户的每用户上限
​
user_email
string
通过提供用户邮箱地址来获取指定用户的配置
必须在 team_level、group_id 或 user_email 中提供一个，以定义作用域。

​
示例请求：获取团队内所有用户的单用户额度上限

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "team_level": true
}' \
https://server.codeium.com/api/v1/GetUsageConfig

​
示例请求：获取组内所有用户的每用户使用上限

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/GetUsageConfig

​
示例请求：获取用户配置

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "user_email": "user@example.com"
}' \
https://server.codeium.com/api/v1/GetUsageConfig

​
响应

​
addOnCreditCap
integer
已配置的附加额度上限值。如果响应中不存在该字段，则表示在所请求的作用域级别未配置任何上限。

​
示例响应 - 已配置额度上限

{
  "addOnCreditCap": 10000
}

​
示例响应 - 未设置上限

{}

​
错误响应

常见错误情况：
  • 服务密钥无效或权限不足
  • 提供了多个 scope 参数
  • 未提供 scope 参数
  • 组 ID 或用户邮箱地址无效
  • 超过速率限制