Sua primeira requisição à API — Documentação NotHoly

Uma chave de cliente, a URL base pública e um modelo ativado. Sem necessidade de criar projeto ou execução.

Crie uma chave com escopos

No console de desenvolvedor, abra Chaves de API. Crie uma chave com runs:write e runs:read e armazene o segredo, exibido uma única vez, em um gerenciador de segredos. Adicione models:read para listar os aliases ativados. Nunca coloque a chave em uma URL, bundle de navegador ou repositório.

Envie uma requisição com limites

Escolha um modelo retornado atualmente pelo catálogo. O exemplo solicita no máximo 256 tokens de saída e desativa as tentativas automáticas do SDK. Uma requisição bem-sucedida consome créditos incluídos ou comprados elegíveis pelas tarifas publicadas do modelo.

Leia o resultado

Chat retorna choices e o uso confirmado como fonte de verdade. Um stream usa chunks nativos. Uma requisição com falha ou resultado incerto não comprova que não houve custo de inferência; use idempotência explícita ao repetir a mesma operação.

Exemplo de requisição

Use sua chave de cliente e um modelo publicado. Copiar um exemplo não envia uma requisição.

curl

curl https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "notholy-pulse",
  "messages": [
    {
      "role": "user",
      "content": "Explain least privilege."
    }
  ],
  "max_tokens": 256
}'

Fixture de contrato HTTP. Verificações com fixtures são distintas da disponibilidade de modelos ao vivo.