Primeiros passos

Início rápido

Faça sua primeira requisição a um modelo da NotHoly em uns dois minutos.

1. Pegue uma chave de API

Crie uma conta em notholy.com/signup e confirme seu e-mail.
Adicione créditos em Cobrança. O depósito mínimo aparece nessa página.
Abra Chaves de API e crie uma chave. Ela começa com nh_live_ e aparece uma única vez.

Exporte a chave no seu shell. Ela vai no cabeçalho Authorization como bearer token.

Shell

export NOTHOLY_API_KEY="nh_live_..."

2. Liste os modelos

curl

curl https://api.notholy.com/v1/models -H "Authorization: Bearer $NOTHOLY_API_KEY"

A lista é pública e mostra os limites e os preços de cada modelo. Veja Modelos.

3. Envie um chat completion

curl https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "notholy-specter", "messages": [{"role": "user", "content": "Explain IDOR in two sentences."}]}'

import os
from openai import OpenAI

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

r = client.chat.completions.create(
    model="notholy-specter",
    messages=[{"role": "user", "content": "Explain IDOR in two sentences."}],
)
print(r.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({ baseURL: 'https://api.notholy.com/v1', apiKey: process.env.NOTHOLY_API_KEY });

const r = await client.chat.completions.create({
  model: 'notholy-specter',
  messages: [{ role: 'user', content: 'Explain IDOR in two sentences.' }],
});
console.log(r.choices[0].message.content);

4. Use streaming

Adicione "stream": true e leia os server-sent events. Cada evento é data: {...}, e o stream termina com data: [DONE]. Veja Streaming.

Pelo terminal

O CLI usa a mesma conta e entra pelo navegador, então você não precisa exportar uma chave.

# macOS and Linux
curl -fsSL https://notholy.com/install.sh | sh

# Windows (PowerShell)
irm https://notholy.com/install.ps1 | iex

Shell

notholy --version
notholy login
notholy "explain IDOR in two sentences"

Cada passo está explicado em Instalar o CLI.

Erros comuns

Status	Código	Como resolver
401	`invalid_api_key`	Confira a chave e o cabeçalho `Authorization: Bearer`
402	`insufficient_credits`	Adicione créditos em Cobrança
404	`model_not_found`	Use um ID de `GET /v1/models`

Próximos passos

Autenticação: cabeçalhos, chaves e erros de autenticação
Modelos: os modelos atuais, limites e preços
Chat completions: a requisição e a resposta completas
SDKs: os SDKs da OpenAI e da Anthropic