Primeiros passos
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) |
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.
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.
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 |