Saltar al contenido

Para desarrolladores

Un centro de IA para todas las aplicaciones que desarrolles.

Tus aplicaciones llaman a nerix en lugar de a cada proveedor de IA. Una clave por servidor, 63 modelos en un mismo formato, un solo saldo de créditos y respuestas que indican qué modelo respondió y cuánto costó.

SDKPHPNodePythonGo

example.ts
// one client per process: it holds your server's key
import { RespireSoftAI } from '@respiresoft/ai'

const ai = new RespireSoftAI()

const answer = await ai.chat.create({
  model: 'mistral/mistral-large-latest',  // or an alias: 'fast'
  messages: [{ role: 'user', content: 'Summarise this contract' }],
  nerix: { tenant: 't42', feature: 'summaries' },
})

answer.nerix.resolved   // the model that actually answered
answer.nerix.cost       // { credits: 2, ... }
Fig. 1 La misma llamada desde Node. En PHP, Python y Go se escribe de forma similar.

01Cómo funciona

Tres pasos, y el primero no sale de tu servidor.

  1. 01

    Genera una clave en tu servidor

    Un solo comando crea una clave privada que solo tu servidor puede leer y muestra su parte pública.

    $ npx respiresoft-ai keygen --out /srv/keys/myapp-ai.pem

    En tu servidor: la clave privada se guarda con permisos exclusivos para el propietario y nunca se muestra.

  2. 02

    Envíanos la parte pública

    Registramos tu aplicación, sus permisos, sus límites y su tarifa en créditos.

  3. 03

    Llama al hub

    Con el SDK para PHP, Node, Python o Go, o con cualquier cliente que pueda firmar una solicitud.

    $ npx respiresoft-ai doctor

    Comprueba la dirección, tu clave, las claves del centro, el reloj y la firma del centro antes de tu primera llamada.

02Funciones disponibles

Chat, búsqueda, imágenes y voz hoy. Agentes próximamente.

Todo lo que aparece a continuación pasa por el mismo punto de acceso con firma, se factura con los mismos créditos y lleva una etiqueta con el modelo que hizo el trabajo.

  • Acceso anticipado

    Chat y transmisión en tiempo real

    Cualquier modelo de chat, con respuestas token a token y uso de herramientas.

  • Acceso anticipado

    Selección automática de modelo

    Envía "auto" como modelo y el hub elige el modelo y el nivel de esfuerzo según reglas fijas, en menos de 5 ms.

  • Acceso anticipado

    Embeddings y búsqueda

    Vectores de cualquier modelo de embeddings y colecciones de búsqueda compartidas, aisladas por aplicación y cliente.

  • Acceso anticipado

    Imágenes

    Imágenes a partir de una descripción escrita, con modelos de OpenAI y Google.

  • Acceso anticipado

    Voz en tiempo real

    Tokens de corta duración para que un teléfono o navegador transmita voz directamente al proveedor de voz.

  • Acceso anticipado

    Más barato si puede esperar

    Marca el trabajo como no urgente y se ejecutará con la tarifa reducida del proveedor.

  • Acceso anticipado

    Agentes, herramientas y documentos escaneados

    Ejecuciones con uso de herramientas, lectura de páginas escaneadas y aprobaciones.

  • Acceso anticipado

    Trabajo programado

    Flujos de trabajo que se ejecutan según un horario o tras la aprobación de alguien.

03Seguridad

Solicitudes firmadas, respuestas firmadas, sin secretos que filtrar.

  • Tu clave nunca sale de tu servidor

    Cada servidor genera su propia clave Ed25519. El centro solo almacena la parte pública, y pueden coexistir dos claves mientras las renuevas.

  • Todas las solicitudes se firman

    El método, la ruta, los parámetros de consulta y un resumen criptográfico del cuerpo, conforme al estándar de firmas de mensajes HTTP (RFC 9421). Se rechaza cualquier solicitud de más de 60 segundos de antigüedad o que ya se haya recibido.

  • Todas las respuestas se firman

    El centro firma las respuestas y las transmisiones, y el SDK las verifica con las claves predefinidas. Si una comprobación falla, el SDK rechaza la respuesta.

  • Privilegios mínimos

    Ámbitos de acceso y límites de frecuencia, tokens y créditos por clave, cliente y función. Los identificadores de cliente son opacos: nunca son un correo electrónico ni un nombre.

04Créditos

Una sola moneda para todas las aplicaciones y todos los modelos.

  • Primero se reservan, luego se liquidan

    Los créditos se reservan antes de cada llamada y se liquidan después, según el coste real del trabajo realizado por el modelo.

  • Una tarifa por aplicación

    Cada aplicación tiene su propia tarifa, fijada al registrarla, para que cada producto pueda establecer un precio distinto para la IA.

  • Un consumo que puedes explicar

    Cada respuesta incluye su consumo (tokens de entrada, de entrada en caché, de salida y de razonamiento) y su coste.

Por ahora, el acceso requiere registro: envíanos el nombre de tu aplicación y la parte pública de su clave.

Habla con nosotros