# Autenticação

> Envie sua chave de API como Bearer token ou em x-api-key. As chaves pertencem a uma organização e podem ter orçamento e limite de modelos.


Toda requisição precisa de uma chave de API. Envie em um destes dois cabeçalhos:

| Cabeçalho | Formato |
|---|---|
| `Authorization` | `Bearer nh_live_...` |
| `x-api-key` | `nh_live_...` (o que os SDKs da Anthropic enviam) |

```bash test
curl https://api.notholy.com/v1/models -H "x-api-key: $NOTHOLY_API_KEY"
```

## Chaves

As chaves são criadas no console, em **Chaves de API**. Cada chave pertence a uma organização e a um workspace. O segredo aparece uma única vez e fica guardado só como hash.

Uma chave pode ter:

- Um orçamento total e um orçamento diário em USD. Uma requisição que estouraria o orçamento recebe `402`.
- Uma lista de modelos permitidos. Os outros modelos recebem `403 key_not_allowed`.
- Uma data de expiração.
- Um limite de requisições por minuto abaixo do limite da organização.

A revogação de uma chave vale a partir da próxima requisição.

## Chaves no código

Leia a chave do ambiente. Não faça commit dela. Se uma chave vazar, revogue no console e crie outra.

> [!WARNING]
> Nunca coloque uma chave em código que roda no cliente. Chame a API do seu servidor ou do seu terminal e guarde as chaves em variáveis de ambiente ou em um cofre de segredos.

```python test
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])

print([m.id for m in client.models.list()])
```

## Erros

| Status | Código | Significado |
|---|---|---|
| 401 | `invalid_api_key` | Chave ausente, errada, revogada ou expirada |
| 403 | `key_not_allowed` | A chave não pode usar este modelo |
| 403 | `account_suspended` | A organização está suspensa. Fale com o suporte |
| 403 | `consent_required` | Quem criou a chave recusou ou retirou o consentimento para processamento nos Estados Unidos e na China. Essa pessoa pode aceitar no console |

## Próximos passos

- [Modelos](/pt-br/getting-started/models)
- [Organizações e papéis](/pt-br/account/organizations)