Primeros pasos.

Consigue tu API key

Tienes que ser miembro de la comunidad NaN. Entra en cloud.nan.builders, abre los ajustes de usuario y ve a la sección API Keys para generar la tuya.

La clave es personal e intransferible, y se muestra una sola vez: cópiala en cuanto la generes. Si la pierdes, no pasa nada, genera otra y borra la vieja desde el mismo panel.

Guárdala en una variable de entorno

# macOS y Linux
export NAN_API_KEY="sk-tu-clave"

# Windows, PowerShell
$env:NAN_API_KEY = "sk-tu-clave"

Así solo dura lo que dure esa terminal. Para que sobreviva a cerrarla, añade la línea a tu ~/.zshrc, a tu ~/.bashrc o a tu perfil de PowerShell.

Haz tu primera llamada

curl https://api.nan.builders/v1/chat/completions \
  -H "Authorization: Bearer $NAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{ "role": "user", "content": "Preséntate en una línea." }]
  }'

Si todo va bien recibes un JSON y el texto del modelo está en choices[0].message.content:

{
  "id": "chatcmpl-...",
  "model": "deepseek-v4-flash",
  "choices": [
    { "index": 0, "message": { "role": "assistant", "content": "Soy un modelo abierto..." } }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 23, "total_tokens": 37 }
}

Ya tienes acceso al clúster. Todo lo demás son variaciones de esta misma llamada.

Lo mismo desde tu código

Usa el SDK oficial de OpenAI y cámbiale la base_url. No hay librería de NaN que instalar.

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NAN_API_KEY"],
    base_url="https://api.nan.builders/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Preséntate en una línea."}],
)
print(resp.choices[0].message.content)

// npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.NAN_API_KEY,
  baseURL: 'https://api.nan.builders/v1',
});

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [{ role: 'user', content: 'Preséntate en una línea.' }],
});
console.log(resp.choices[0].message.content);

Tienes más ejemplos, incluidos embeddings, voz, imágenes y búsqueda web, en Ejemplos.

Elige el modelo

deepseek-v4-flash es un buen punto de partida, pero no es el único ni el mejor para todo. La lista completa, con cuál conviene para cada cosa, está en Elige tu modelo.

Y la lista que de verdad puede usar tu clave siempre te la da la API:

curl https://api.nan.builders/v1/models \
  -H "Authorization: Bearer $NAN_API_KEY"

Conecta tu editor o tu agente

Cursor, Codex, VS Code, Cline, OpenCode, Zed y compañía se configuran con esos mismos dos datos. Cada uno los pide en un sitio distinto, y eso es lo que recoge Configurar tu agente, con una página por herramienta.

Claude Code es la única excepción, y no es cuestión de dónde van los campos: habla el protocolo de Anthropic, así que no apunta a NaN directamente. En su página están las dos maneras de resolverlo.

Si usas OpenCode, Codex, Pi o droid, el CLI de NaN te los configura sin que tengas que editar nada.