Saltar a la documentación

Tu primera solicitud a la API

Una clave de cliente, la URL base pública y un modelo activado. No hace falta crear un proyecto ni una ejecución.

Actualizado el 31 de octubre de 2026

Crea una clave con permisos limitados

En la consola de desarrollador, abre Claves de API. Crea una clave con runs:write y runs:read y guarda el secreto, que solo se muestra una vez, en un gestor de secretos. Añade models:read para listar los alias activados. Nunca incluyas la clave en una URL, un bundle del navegador o un repositorio.

Envía una solicitud con límites

Elige un modelo que devuelva actualmente el catálogo. El ejemplo solicita como máximo 256 tokens de salida y desactiva los reintentos automáticos del SDK. Una solicitud correcta consume créditos incluidos o comprados elegibles según las tarifas publicadas del modelo.

Lee el resultado

Chat devuelve choices y el uso confirmado como fuente de verdad. Un stream usa chunks nativos. Una solicitud fallida o incierta no demuestra que no haya habido coste de inferencia; usa idempotencia explícita al repetir la misma operación.

Ejemplo de solicitud

Usa tu clave de cliente y un modelo publicado. Copiar un ejemplo no envía una solicitud.

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. Las comprobaciones con fixtures son distintas de la disponibilidad de modelos en vivo.