Skip to main content
POST
Criar uma nova chave de API
Este endpoint requer uma chave de API de gerenciamento. Chaves de API padrão do Gateway não são aceitas.
A chave de API em texto simples é retornada uma única vez, durante a criação. Os campos de compatibilidade limit, limit_reset e include_byok_in_limit são aceitos; atualmente, o Phaseo trata include_byok_in_limit apenas para compatibilidade e sempre exclui BYOK do limite dessa chave.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
name
string
obrigatório
Minimum string length: 1
Exemplo:

"Analytics Service Key"

workspace_id
string<uuid>

Substituição opcional do espaço de trabalho para chamadas internas.

scopes
Exemplo:

"[\"chat.completions\",\"responses\"]"

limit
number | null

Limite de gastos opcional em USD para esta chave.

Intervalo obrigatório: x >= 0
limit_reset
enum<string>

Período usado para a janela do limite de gastos.

Opções disponíveis:
daily,
weekly,
monthly
include_byok_in_limit
boolean

Aceito por compatibilidade. O comportamento atual do Phaseo sempre exclui o BYOK deste limite.

expires_at
string<date-time> | null
disabled
boolean
padrão:false
soft_blocked
boolean
padrão:false
limits
object

Resposta

Chave de API criada

data
object
obrigatório
Última modificação em 2 de outubro de 2026