← NEXIA API Docs · v1

Documentación de la API

Integra la inteligencia de NEXIA en tu aplicación con una sola petición HTTP. Sin SDK obligatorio: cualquier lenguaje que haga un POST funciona.

Introducción Autenticación Generar respuesta Planes Créditos y límites

Introducción

Todas las peticiones se hacen sobre HTTPS a la URL base:

https://nexura-ecr.com/api/v1

¿Aún no tienes llave? Crea tu cuenta gratis y obtén créditos de prueba al instante.

Autenticación

Autentícate con tu llave API en el header Authorization. También aceptamos el header X-API-Key.

Authorization: Bearer nxk_live_tu_llave

🔒 Tu llave es secreta. Úsala solo desde tu servidor — nunca la expongas en el navegador ni en apps públicas.

Generar una respuesta

POST /api/v1/nexia

Parámetros (cuerpo JSON)

Campo	Tipo	Requerido	Descripción
`prompt`	string	Sí	El texto o pregunta que quieres que NEXIA responda. (También acepta `message`.)
`max_tokens`	entero	No	Longitud máxima de la respuesta. Por defecto 512. Rango 64–2048.
`grounded`	boolean	No	Si NEXIA usa su conocimiento experto de 149 carreras. Por defecto `true`.
`carrera`	string	No	Enfoca el conocimiento en una carrera concreta (ej. "Medicina").

Ejemplo de petición

curl -X POST https://nexura-ecr.com/api/v1/nexia \
  -H "Authorization: Bearer nxk_live_tu_llave" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Resume la fotosíntesis en 3 líneas"}'

const res = await fetch("https://nexura-ecr.com/api/v1/nexia", {
  method: "POST",
  headers: {
    "Authorization": "Bearer nxk_live_tu_llave",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ prompt: "Resume la fotosíntesis en 3 líneas" })
});
const data = await res.json();
console.log(data.text);

import requests

res = requests.post(
    "https://nexura-ecr.com/api/v1/nexia",
    headers={"Authorization": "Bearer nxk_live_tu_llave"},
    json={"prompt": "Resume la fotosíntesis en 3 líneas"},
)
print(res.json()["text"])

$ch = curl_init("https://nexura-ecr.com/api/v1/nexia");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer nxk_live_tu_llave",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["prompt" => "Resume la fotosíntesis en 3 líneas"]),
]);
$data = json_decode(curl_exec($ch), true);
echo $data["text"];

Respuesta 200 OK

{
  "ok": true,
  "text": "La fotosíntesis es el proceso por el que las plantas...",
  "grounded": true,
  "usage": { "tokens_in": 699, "tokens_out": 120, "credits": 3 },
  "credits_restantes": 27
}

Códigos de error

`400`	Falta el `prompt` en el cuerpo JSON.
`401`	Llave API ausente o inválida.
`402`	Sin créditos. Recarga tu saldo.
`429`	Límite de tasa: máximo 30 llamadas por minuto.
`502`	La inteligencia no está disponible momentáneamente. No se descuentan créditos.

Todos los errores devuelven { "ok": false, "error": "..." }.

Catálogo de planes

GET /api/v1/plans — público, sin autenticación

Plan	Créditos	Precio	Por crédito
Free	100	$0.00 USD	—
Starter	5,000	$9.00 USD	$0.0018
Pro	30,000	$49.00 USD	$0.0016
Business	150,000	$199.00 USD	$0.0013
Prueba (test)	500	$1.00 USD	$0.0020

Créditos y límites

Cada respuesta consume créditos según los tokens usados (lo ves en usage.credits y el saldo en credits_restantes).
Límite de tasa: 30 llamadas por minuto por cliente.
Si una respuesta falla por nuestro lado (error 502), no se descuentan créditos.
Recarga tu saldo cuando quieras — la acreditación es automática.

Obtener mi llave → Recargar créditos