Começar
Autenticação
Chaves de API, escopos, orçamento por chave e boas práticas.
Toda chamada a /v1 exige uma chave de API no cabeçalho Authorization:
HTTP
Authorization: Bearer isc_...Escopos
| Campo | Tipo | Descrição |
|---|---|---|
chat | escopo | Permite POST /chat/completions. |
models | escopo | Permite GET /models e GET /models/{id}. |
balance | escopo | Permite GET /balance. |
usage | escopo | Permite GET /usage. |
Uma chave sem o escopo necessário recebe 403 key_forbidden.
Orçamento e validade
Ao criar a chave você pode definir um orçamento máximo em reais e uma data de validade. Quando o orçamento acaba, a chave recebe 402 key_budget, mesmo com saldo na conta. Chaves expiradas ou revogadas recebem 401 invalid_api_key.
Boas práticas
- Nunca exponha a chave no navegador ou em aplicativos móveis; chame a API a partir do seu servidor.
- Use uma chave por aplicação ou ambiente, com o menor conjunto de escopos e um orçamento.
- Se uma chave vazar, revogue-a no console. A revogação vale imediatamente.
- O segredo é exibido só na criação; a ISC guarda apenas um hash e não consegue recuperá-lo.