Docs

Elige tu modelo.

En NaN cambiar de modelo es cambiar una palabra. Todos se llaman igual, por el mismo endpoint y con el mismo formato de petición: lo único que cambia es el valor del campo model.

{
  "model": "deepseek-v4-flash",
  "messages": [{ "role": "user", "content": "Hola" }]
}

Ese valor es el id del modelo, y tiene que escribirse exacto. Un punto de más o un guion de menos y la API responde 404 con model_not_found. Esta página es la lista buena.

Empieza por aquí

Si no sabes cuál coger, busca en la primera columna lo que quieres hacer.

QuieroPidePor qué
Chatear o razonar sobre algo, sin másdeepseek-v4-flashEs el mejor de propósito general del clúster y lee imágenes
Mover un agente de código en sesiones largasglm5.3Está pensado para eso. Necesita el tier premium
Lo mismo, pero sin el tier premiumglm5.3-flashMismo contexto de 1M y cuota generosa
Que conteste rápidoqwen3.8-flashMenos profundidad, mucha menos espera
Pasarle un audio al modelo directamentemimo-v2.5Es el único que oye
Describir o analizar una imagendeepseek-v4-flashCualquiera menos glm5.3 sirve; este es el mejor
Probar cosas sin gastar cuotagemma4No tiene contador de tokens
Montar un buscador o un RAGqwen3-embedding y después rerankPrimero recuperas por similitud, luego reordenas por relevancia
Convertir texto en audiokokoro67 voces, dos de ellas en español
Transcribir audiowhisperMás de 99 idiomas, con detección automática
Generar o editar una imagenflux-2-kleinTexto a imagen e imagen a imagen

Todos los modelos

idPara quéContextoAceptaCuota
deepseek-v4-flashChat y razonamiento general1Mtexto · imagen3B tokens/mes
glm5.3Agentes de código y tareas largas1Mtexto3B tokens/periodo de facturación
glm5.3-flashAgentes de código, sin premium1Mtexto · imagen2B tokens/mes
qwen3.8-flashRespuestas rápidas262Ktexto · imagen500M tokens/mes
mimo-v2.5Audio de entrada, omnimodal1Mtexto · imagen · audio1.0B tokens/mes
gemma4Tareas cortas y pruebas262Ktexto · imagensin contador
qwen3.6Generación anterior262Ktexto · imagensin contador
qwen3-embeddingVectores de 4096 dimensiones-textosin contador
rerankReordenar por relevancia-textosin contador
kokoroTexto a voz-textosin contador
whisperVoz a texto-audiosin contador
flux-2-kleinGenerar y editar imágenes-texto · imagen100 peticiones/mes

Las fichas completas, con parámetros, licencias y modos de razonamiento, están en Modelos.

glm5.3 es el único que no entra con la suscripción normal Necesita una clave en el tier premium. Si lo pides sin él, la respuesta es un 401, no un 403: “This API key does not have access to the requested model”. Parece una clave rota y no lo es, así que mira el tier antes de ponerte a rotar credenciales. Tampoco aparece en GET /v1/models. Todos los demás los puede llamar cualquier miembro.

Cómo se leen los ids

  • El id no es el nombre comercial. El modelo que en su casa se llama “GLM 5.3 Flash” aquí es glm5.3-flash, en minúsculas, sin espacios y con el punto de la versión.
  • -flash significa rápido, no pequeño ni peor: son variantes optimizadas para latencia.
  • El punto de la versión cuenta. qwen3.6 y qwen3.8-flash son modelos distintos, y mimo-v2.5 lleva el punto donde lo lleva.
  • Los ids no cambian de significado. Cuando servimos una variante nueva de un modelo mantenemos su id si la API es la misma. deepseek-v4-flash, por ejemplo, pasó a leer imágenes sin cambiar de nombre.
  • Los ids viejos no se apagan de golpe. qwen3.6 sigue respondiendo para que las configuraciones que ya lo nombran no se rompan, pero no es lo que te conviene si empiezas hoy.

Qué significa la cuota

La columna de cuota cuenta tres cosas distintas:

  • /mes es un contador de tokens que vuelve a cero con el mes natural.
  • /periodo de facturación vuelve a cero cuando arranca tu periodo en Stripe, que casi nunca es el día 1. Solo glm5.3 va así, y además tiene un tope aparte de tokens por cada ventana móvil de 4 horas, que es con el que topa antes una sesión intensiva de agente.
  • sin contador significa que no hay contador de tokens asociado, no que sea infinito: los límites de peticiones por minuto se aplican igual a todos.

Cuando agotas una cuota, la API responde 402 o 429 y no se arregla reintentando. Las cifras vigentes de límites están al final de Modelos.

La lista que puede usar tu clave

Esta página se escribe a mano y el clúster se mueve. La respuesta definitiva, y además filtrada por lo que tu clave puede llamar de verdad, te la da la propia API:

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

Si un id aparece ahí, funciona. Si no aparece, no lo tienes disponible, aunque lo leas en otro sitio.

Siguientes pasos

  • Configurar tu agente: dónde poner el id en Cursor, Claude Code, Codex, Cline, OpenCode o Zed.
  • Ejemplos: una llamada completa por cada tipo de modelo.
  • Modelos: las fichas técnicas, modelo a modelo.
nan.builders © 2026
Copied to clipboard