跳转到主要内容
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
}

概览

获取你所在组织当前的每用户附加用量额度上限配置。额度上限一律按用户设置。当你按团队或群组范围发起查询时,响应会返回已应用于该团队或群组内用户的每用户额度上限。

请求

service_key
string
必填
具有 “Billing Read” 权限的服务密钥

范围配置(任选其一)

team_level
boolean
将其设置为 true 以获取应用于该团队所有用户的每用户上限
group_id
string
通过提供组 ID 获取应用于该组所有用户的每用户上限
user_email
string
通过提供用户的电子邮箱地址获取该用户的配置
必须在 team_levelgroup_iduser_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 或用户邮箱无效
  • 超出速率限制