¿Cómo obtengo una clave de API?

Regístrate en Cruxy y crea una clave con el flujo de inicio de sesión por dispositivo descrito en la guía de inicio rápido: solicita un código de dispositivo, apruébalo en el navegador y consulta hasta recibir la clave. Las claves de API salen de la misma cuenta que la app, y la API se factura por token, por separado de tu plan.

¿Qué modelo debo indicar?

Indica auto salvo que tengas un motivo para no hacerlo. Mira es el tamaño rápido para llamadas cortas y de alto volumen, Vaani es el predeterminado equilibrado y Kavi es el tamaño profundo para las tareas más difíciles. El modelo detrás de un tamaño puede cambiar; el id del tamaño es el contrato.

Cualquier cliente de OpenAI funciona para chat completions y modelos, en el lenguaje que ya uses. Para las rutas propias de Cruxy, la documentación muestra la solicitud en curl y en TypeScript con fetch.

¿Mis datos se usan para entrenar?

Tus prompts y resultados no se usan para entrenar modelos de IA sin tu consentimiento explícito y por separado. Los registros de solicitudes guardan el modelo, los recuentos de tokens, el costo y los tiempos, y nada del contenido. La política de privacidad lo cuenta al completo.

Desarrolladores

Construye lo que viene.

Una URL base, una clave y tres tamaños de modelo detrás. Una API compatible con OpenAI para chat, las rutas propias de Cruxy cuando quieres memoria, bóvedas, archivos y evals, y una CLI que funciona en tu repo.

Empieza gratis Leer la guía de inicio rápido

import OpenAI from 'openai';

const cruxy = new OpenAI({
  baseURL: 'https://api.cruxy.ai/v1',
  apiKey: process.env.CRUXY_API_KEY,
});

const res = await cruxy.chat.completions.create({
  model: 'auto',
  messages: [{ role: 'user', content: 'Summarize this ticket' }],
});

import os
from openai import OpenAI

cruxy = OpenAI(
    base_url="https://api.cruxy.ai/v1",
    api_key=os.environ["CRUXY_API_KEY"],
)

res = cruxy.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Summarize this ticket"}],
)

curl https://api.cruxy.ai/v1/chat/completions \
  -H "Authorization: Bearer $CRUXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto",
       "messages": [{"role": "user",
                     "content": "Summarize this ticket"}]}'

Response · chat.completion

{
  "id": "chatcmpl-8f3a1c2d",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Checkout fails on UPI when the cart
          holds a gift card. Steps to reproduce and
          a fix are below."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 212,
    "completion_tokens": 96,
    "total_tokens": 308
  }
}

La solicitud es real. La respuesta es ilustrativa y está recortada a su forma.

URL base: api.cruxy.ai/v1
Modelos: kavi · vaani · mira · auto
Streaming: Los SSE de OpenAI, terminan con [DONE]
Errores: Un código estable en cada uno

La plataforma

Todo sobre lo que puedes construir. Todo disponible, todo documentado.

API de chatDisponibleChat completions compatibles con OpenAI en tres tamaños de modelo. Streaming, llamadas a herramientas y un reasoning_effort que fijas por solicitud.Guía de chat Cruxy CodeDisponibleUn agente de programación para tu terminal. Lee tu base de código, edita archivos con un diff antes de cada aprobación, ejecuta tus pruebas y abre pull requests.Explorar Cruxy Code Evals APIDisponibleSuites de casos que defines, ejecuciones que inicias, resultados que lees. Apunta una herramienta de evaluación a las rutas compatibles con OpenAI, o usa las rutas de evals directamente.Referencia de la API Embeddings, rerank y moderaciónDisponiblecruxy-embed convierte texto en vectores, cruxy-rerank ordena candidatos según una consulta y cruxy-guard clasifica texto según categorías de seguridad de contenido.Recetario DocumentaciónDisponibleUna guía de inicio rápido, una guía para cada ruta, un recetario con recuperación, bucles de herramientas y streaming en el navegador, y la referencia completa de la API.Leer la documentación EstadoDisponibleComprobaciones en vivo e incidentes, en su propio dominio, para que puedas comprobarnos a nosotros antes de comprobar tu código.Ver el estado

Chat

Dos rutas, un mismo conjunto de modelos. Usa la que tu cliente ya habla.

Guía de chat

POST /v1/chat/completions

Compatible con OpenAI

Apunta cualquier cliente de OpenAI o herramienta de evaluación a https://api.cruxy.ai/v1 con tu clave de Cruxy. Objetos chat.completion estándar, los SSE de OpenAI y el envoltorio de errores de OpenAI, con un código estable de Cruxy dentro.

temperature, top_p, max_tokens y reasoning_effort se respetan
Los campos que la pasarela no usa se ignoran, no se rechazan, así que una herramienta de evaluación que los envíe sigue funcionando
Una ejecución reproducible de tus mensajes y el modelo. Sin memoria, sin bóvedas, sin archivos

POST /api/v1/chat

Chat de Cruxy

Los mismos modelos con todo lo que tiene la app de Cruxy: recuperación y captura de memoria, bóvedas y reglas permanentes, archivos por id y usage.cost en cada respuesta.

memory: { recall, capture } por solicitud, reglas activadas o desactivadas, un vault_id
usage.cost con el nivel, el importe y la moneda en cada respuesta
cruxy.request_id para buscar la llamada en tus registros y emparejarla con feedback

const stream = await cruxy.chat.completions.create({
  model: 'auto',
  stream: true,
  messages: [{ role: 'user', content: 'Draft the release note' }],
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

stream = cruxy.chat.completions.create(
    model="auto",
    stream=True,
    messages=[{"role": "user", "content": "Draft the release note"}],
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

curl -N https://api.cruxy.ai/v1/chat/completions \
  -H "Authorization: Bearer $CRUXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "stream": true,
       "messages": [{"role": "user",
                     "content": "Draft the release note"}]}'

STREAMING

Pon stream en true y la respuesta llega como eventos enviados por el servidor (SSE) en el formato de OpenAI: frames chat.completion.chunk con deltas de contenido o de llamadas a herramientas, y después [DONE].

Si el origen falla a mitad del stream, el stream termina con un frame de error en lugar de [DONE], para que tu cliente distinga un corte de un final. Las llamadas a herramientas funcionan en ambas rutas: envía las funciones que el modelo puede llamar, ejecuta las que devuelva y devuélvele los resultados.

Guía de llamadas a herramientas

La API

Cada ruta, en una línea. Las rutas tal como las lista la referencia.

Referencia completa de la API

GRUPORUTASQUÉ HACEDOCUMENTACIÓN

Chat

POST /v1/chat/completions
POST /api/v1/chat
POST /api/v1/tokens/count

Chat completions compatibles con OpenAI, el chat propio de Cruxy con memoria, bóvedas, reglas y archivos, y un contador de tokens.Guía de chat

Modelos

GET /v1/models
GET /api/v1/models

El catálogo de niveles, como lista de OpenAI o con los metadatos propios de Cruxy: ventana de contexto, precios, compatibilidad con herramientas y valores de razonamiento predeterminados.Referencia de modelos

Llamadas a herramientas

"tools": [ ... ] on every chat route

Envía las funciones que el modelo puede llamar, ejecuta las llamadas que devuelva y devuélvele los resultados.Guía de llamadas a herramientas

Embeddings y rerank

POST /api/v1/embeddings
POST /api/v1/rerank

Convierte texto en vectores con cruxy-embed y ordena documentos candidatos según una consulta con cruxy-rerank.Guía de embeddings

Moderación

POST /api/v1/moderations

Clasifica texto según categorías de seguridad de contenido con cruxy-guard y actúa según el booleano flagged.Guía de moderación

Archivos

POST /api/v1/files
GET /api/v1/files/{id}/content

Sube, lista, descarga y elimina archivos, y luego adjúntalos por id a las solicitudes de chat de Cruxy.Referencia de la API

Evals

POST /api/v1/evals/suites
POST /api/v1/evals/suites/{id}/runs

Suites de casos que defines, ejecuciones que inicias y resultados que lees.Referencia de la API

Feedback

POST /api/v1/feedback

Informa del resultado de una llamada anterior por su id de solicitud: aceptaciones, rechazos, pulgares arriba o abajo y resultados de pruebas.Guía de feedback

Memoria, bóvedas y reglas

GET /api/v1/memories
POST /api/v1/vaults
PUT /api/v1/rules

Lee y elimina recuerdos, gestiona bóvedas y sus miembros, y fija reglas permanentes para una cuenta o una bóveda.Referencia de la API

Límites y registros

GET /api/v1/limits
GET /api/v1/logs/{request_id}

Tus topes de solicitudes por clave y por organización, y el registro de tus solicitudes por id de solicitud.Referencia de errores

Claves y organización

POST /api/v1/device/code
GET /api/v1/org/members
POST /api/v1/workspaces

Inicio de sesión por dispositivo para obtener una clave, los miembros e invitaciones de tu organización, y espacios de trabajo.Guía de autenticación

Operar

Límites, registros y errores que puedes entender.

Referencia de errores

Límites que puedes consultar

GET /api/v1/limits devuelve tus topes de solicitudes de chat por clave y por organización para cada ventana de 60 segundos, y la pasarela envía cabeceras X-RateLimit. No hay límite de tokens por minuto.

Dos tipos de 429

rate_limited significa que las solicitudes llegan demasiado rápido; se resuelve en cuanto bajas el ritmo. budget_exhausted es un tope de gasto que un reintento por sí solo no resuelve.

Registros por id de solicitud

Cada solicitud se registra con el modelo, los recuentos de tokens, el costo, los tiempos y el estado, y nada del prompt ni de la respuesta. Consulta uno en GET /api/v1/logs/{request_id}.

Claves mostradas una sola vez

Obtén una clave con el flujo de inicio de sesión por dispositivo. Se muestra exactamente una vez y se guarda solo como hash. Los secretos en reposo se cifran campo por campo con AES-256-GCM.

Disponible

Cruxy Code

Los mismos modelos, en tu terminal.

Planifica cambios de varios pasos y muestra cada diff antes de que lo apruebes
Pregunta antes de cada edición y cada comando, por defecto
Ejecuta tu comando de pruebas, lee los fallos y sigue corrigiendo
cruxy rollback restaura el árbol a como estaba antes de cualquier turno
cruxy pr abre la pull request tras una sola aprobación

npm i -g @cruxy/cliExplorar Cruxy Code

~/web · Cruxy Code

$cruxy run "fix the failing tests in the auth module"
cruxy › fix the failing tests in the auth module
! cruxy wants to run tests: pnpm test (destructive)
  $ pnpm test
  in /home/dev/web
  [y] once · [a] always allow test runs of exactly `pnpm test` this session · [t] reject & instruct · [n] no: a
✗ tests failed · 2 of 42 failed · 3.1s · pnpm test
  ✗ signs a session token src/auth/session.test.ts:18
      expected  "ok"
      received  undefined
  ✗ rejects an expired token src/auth/session.test.ts:41
  why (inferred)  TOKEN_SECRET is not set in the test environment
✓ read_file      8ms  src/test/setup.ts
? cruxy wants to edit: src/test/setup.ts (mutate)

Una sesión real, recortada. La salida de la CLI es real; las respuestas del modelo son ilustrativas.

Precios de la API

Por token, en USD. Sin costo de configuración ni mínimo.

Precios de la API en detalle

Fast· Mira

Llamadas cortas y de alto volumen donde la latencia y el costo importan más.

ENTRADA: $0.20 / 1M
SALIDA: $0.40 / 1M

Contexto: 64K
Salida máxima: 2K

Balanced· Vaani

Llamadas cotidianas: buena calidad con menor latencia y costo.

ENTRADA: $0.65 / 1M
SALIDA: $1.30 / 1M

Contexto: 128K
Salida máxima: 4K

Deep· Kavi

Las tareas más difíciles: razonamiento profundo y el mayor presupuesto de salida.

ENTRADA: $0.76 / 1M
SALIDA: $1.52 / 1M

Contexto: 256K
Salida máxima: 8K

USD por 1M de tokens, medido por solicitud. Los precios de la API no incluyen GST. Se añade un 18% de GST a las cuentas facturadas en India (con crédito fiscal disponible). Con auto, pagas la tarifa del modelo que atendió la llamada.

Preguntas

Conviene saberlo.

Moderación con cualquier claveFiltra la entrada con cruxy-guard antes de que llegue al chat. La API de moderación acepta cualquier clave en cualquier plan.

Sí, para chat y la lista de modelos. https://api.cruxy.ai/v1 sirve /v1/chat/completions y /v1/models con las formas de OpenAI, así que los clientes y herramientas de evaluación existentes funcionan en cuanto cambias la URL base y la clave. El resto de la API, de archivos a evals, es propia de Cruxy y vive bajo /api/v1.

Cambia la URL base. Conserva tu código.

Empieza gratis, paga por token y consulta cada límite antes de alcanzarlo.

Empieza gratis Referencia de la API

import OpenAI from 'openai'; const cruxy = new OpenAI({ baseURL: 'https://api.cruxy.ai/v1', apiKey: process.env.CRUXY_API_KEY, }); const res = await cruxy.chat.completions.create({ model: 'auto', messages: [{ role: 'user', content: 'Summarize this ticket' }], });

import os from openai import OpenAI cruxy = OpenAI( base_url="https://api.cruxy.ai/v1", api_key=os.environ["CRUXY_API_KEY"], ) res = cruxy.chat.completions.create( model="auto", messages=[{"role": "user", "content": "Summarize this ticket"}], )

curl https://api.cruxy.ai/v1/chat/completions \ -H "Authorization: Bearer $CRUXY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "auto", "messages": [{"role": "user", "content": "Summarize this ticket"}]}'

{ "id": "chatcmpl-8f3a1c2d", "object": "chat.completion", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Checkout fails on UPI when the cart holds a gift card. Steps to reproduce and a fix are below." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 212, "completion_tokens": 96, "total_tokens": 308 } }

const stream = await cruxy.chat.completions.create({ model: 'auto', stream: true, messages: [{ role: 'user', content: 'Draft the release note' }], }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ''); }

stream = cruxy.chat.completions.create( model="auto", stream=True, messages=[{"role": "user", "content": "Draft the release note"}], ) for chunk in stream: print(chunk.choices[0].delta.content or "", end="")

curl -N https://api.cruxy.ai/v1/chat/completions \ -H "Authorization: Bearer $CRUXY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "auto", "stream": true, "messages": [{"role": "user", "content": "Draft the release note"}]}'

$cruxy run "fix the failing tests in the auth module" cruxy › fix the failing tests in the auth module ! cruxy wants to run tests: pnpm test (destructive) $ pnpm test in /home/dev/web [y] once · [a] always allow test runs of exactly `pnpm test` this session · [t] reject & instruct · [n] no: a ✗ tests failed · 2 of 42 failed · 3.1s · pnpm test ✗ signs a session token src/auth/session.test.ts:18 expected "ok" received undefined ✗ rejects an expired token src/auth/session.test.ts:41 why (inferred) TOKEN_SECRET is not set in the test environment ✓ read_file 8ms src/test/setup.ts ? cruxy wants to edit: src/test/setup.ts (mutate)

Construye lo que viene.

Todo sobre lo que puedes construir. Todo disponible, todo documentado.

Dos rutas, un mismo conjunto de modelos. Usa la que tu cliente ya habla.

Compatible con OpenAI

Chat de Cruxy

Cada ruta, en una línea. Las rutas tal como las lista la referencia.

Límites, registros y errores que puedes entender.

Límites que puedes consultar

Dos tipos de 429

Registros por id de solicitud

Claves mostradas una sola vez

Los mismos modelos, en tu terminal.

Por token, en USD. Sin costo de configuración ni mínimo.

Conviene saberlo.

¿La API es compatible con OpenAI?

¿Cómo obtengo una clave de API?

¿Qué modelo debo indicar?

¿Tienen un SDK?

¿Mis datos se usan para entrenar?

Cambia la URL base. Conserva tu código.

Construye lo que viene.

Todo sobre lo que puedes construir. Todo disponible, todo documentado.

Dos rutas, un mismo conjunto de modelos. Usa la que tu cliente ya habla.

Compatible con OpenAI

Chat de Cruxy

Cada ruta, en una línea. Las rutas tal como las lista la referencia.

Límites, registros y errores que puedes entender.

Límites que puedes consultar

Dos tipos de 429

Registros por id de solicitud

Claves mostradas una sola vez

Los mismos modelos, en tu terminal.

Por token, en USD. Sin costo de configuración ni mínimo.

Conviene saberlo.

¿La API es compatible con OpenAI?

¿Cómo obtengo una clave de API?

¿Qué modelo debo indicar?

¿Tienen un SDK?

¿Mis datos se usan para entrenar?

Cambia la URL base. Conserva tu código.