Empezar

Inicio rápido

Haz tu primera solicitud a un modelo de NotHoly en unos dos minutos.

1. Consigue una clave de API

Crea una cuenta en notholy.com/signup y confirma tu e-mail.
Agrega créditos en Facturación. El depósito mínimo aparece en esa página.
Abre Claves de API y crea una clave. Empieza con nh_live_ y se muestra una sola vez.

Expórtala en tu shell. Va en el encabezado Authorization como token bearer.

Shell

export NOTHOLY_API_KEY="nh_live_..."

2. Lista los modelos

curl

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

La lista es pública y muestra los límites y precios de cada modelo. Consulta Modelos.

3. Envía un 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. Usa streaming

Agrega "stream": true y lee los server-sent events. Cada evento es data: {...}, y el stream termina con data: [DONE]. Consulta Streaming.

Desde la terminal

El CLI usa la misma cuenta e inicia sesión desde el navegador, así que no necesitas exportar una clave.

# 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 paso se explica en Instalar el CLI.

Errores comunes

Estado	Código	Solución
401	`invalid_api_key`	Revisa la clave y el encabezado `Authorization: Bearer`
402	`insufficient_credits`	Agrega créditos en Facturación
404	`model_not_found`	Usa un ID de `GET /v1/models`

Siguientes pasos

Autenticación: encabezados, claves y errores de autenticación
Modelos: los modelos actuales, sus límites y precios
Chat completions: la solicitud y la respuesta completas
SDKs: los SDK de OpenAI y Anthropic