Pular para o conteúdo principal
POST
/
api
/
v1
/
UsageConfig
Definir configuração de uso
curl --request POST \
  --url https://server.codeium.com/api/v1/UsageConfig \
  --header 'Content-Type: application/json' \
  --data '{
  "service_key": "<string>",
  "clear_add_on_credit_cap": true,
  "set_add_on_credit_cap": 123,
  "team_level": true,
  "group_id": "<string>",
  "user_email": "<string>"
}'

Visão geral

Defina ou remova limites de uso para créditos de add-on da sua organização. Você pode aplicar essas configurações no nível da equipe, para grupos específicos ou para usuários individuais.

Requisição

service_key
string
required
Sua Chave de serviço com as permissões adequadas

Configuração do limite de crédito (Escolha uma)

clear_add_on_credit_cap
boolean
Defina como true para limpar o limite de crédito do add-on existente
set_add_on_credit_cap
integer
Defina um novo limite de crédito do add-on (valor inteiro)
Você deve fornecer clear_add_on_credit_cap ou set_add_on_credit_cap, mas não ambos.

Configuração de escopo (escolha uma)

team_level
boolean
Defina como true para aplicar a configuração no nível da equipe
group_id
string
Aplique a configuração a um grupo específico fornecendo o ID do grupo
user_email
string
Aplique a configuração a um usuário específico fornecendo o endereço de e-mail
Você deve fornecer um de team_level, group_id ou user_email para definir o escopo.

Exemplo de solicitação - Definir limite de crédito para a equipe

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

Exemplo de solicitação — Definir limite de créditos para o grupo

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "sua_chave_de_servico_aqui",
  "set_add_on_credit_cap": 5000,
  "group_id": "equipe_de_engenharia"
}' \
https://server.codeium.com/api/v1/UsageConfig

Exemplo de solicitação - Definir limite de crédito para o usuário

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "sua_chave_de_servico_aqui",
  "set_add_on_credit_cap": 1000,
  "user_email": "usuario@exemplo.com"
}' \
https://server.codeium.com/api/v1/UsageConfig

Exemplo de solicitação — Limpar limite de créditos

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

Resposta

O corpo da resposta está vazio. Um código de status 200 indica que a operação foi concluída com sucesso.

Respostas de erro

Cenários de erro comuns:
  • Service Key inválida ou permissões insuficientes
  • Ambos clear_add_on_credit_cap e set_add_on_credit_cap fornecidos
  • Nem clear_add_on_credit_cap nem set_add_on_credit_cap fornecidos
  • Múltiplos parâmetros de escopo fornecidos
  • Nenhum parâmetro de escopo fornecido
  • ID de grupo ou e-mail de usuário inválido
  • Limite de requisições excedido