Come ottengo una chiave API?

Registrati a Cruxy e crea una chiave con il flusso di device login descritto nella guida rapida: richiedi un codice dispositivo, approvalo nel browser e fai polling per la chiave. Le chiavi API vengono dallo stesso account dell'app, e l'API è fatturata per token, separatamente dal tuo piano.

Quale modello dovrei passare?

Passa auto a meno che tu non abbia un motivo per non farlo. Mira è la taglia fast per chiamate brevi e ad alto volume, Vaani è il predefinito bilanciato, e Kavi è la taglia deep per le attività più difficili. Il modello dietro una taglia può cambiare; l'id della taglia è il contratto.

Qualsiasi client OpenAI funziona per chat completions e modelli, in qualunque linguaggio tu già usi. Per le route proprie di Cruxy, la documentazione mostra la richiesta in curl e in TypeScript con fetch.

I miei dati vengono usati per l'addestramento?

I tuoi prompt e output non vengono usati per addestrare modelli AI senza il tuo consenso esplicito e separato. I log delle richieste conservano modello, conteggi di token, costo e tempi, e nulla del contenuto. L'informativa sulla privacy ha il resoconto completo.

Sviluppatori

Costruisci ciò che viene dopo.

Un unico URL di base, una sola chiave e tre taglie di modello dietro. Un'API compatibile con OpenAI per la chat, le route proprie di Cruxy quando vuoi memoria, casseforti, file ed eval, e una CLI che lavora nel tuo repository.

Inizia gratis Leggi la guida rapida

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 richiesta è reale. La risposta è illustrativa e ridotta alla sua forma.

URL di base: api.cruxy.ai/v1
Modelli: kavi · vaani · mira · auto
Streaming: SSE di OpenAI, termina con [DONE]
Errori: Un codice stabile su ognuno

La piattaforma

Tutto ciò su cui puoi costruire. Tutto disponibile, tutto documentato.

Chat APIDisponibileChat completions compatibili con OpenAI su tre taglie di modello. Streaming, tool calling e un reasoning_effort che imposti per richiesta.Guida alla chat Cruxy CodeDisponibileUn agente di coding per il tuo terminale. Legge la tua codebase, modifica i file con un diff prima di ogni approvazione, esegue i tuoi test e apre pull request.Esplora Cruxy Code Evals APIDisponibileSuite di casi che definisci, esecuzioni che avvii, risultati che rileggi. Punta un harness di valutazione alle route compatibili con OpenAI, o usa direttamente le route eval.Riferimento API Embedding, rerank e moderazioneDisponibilecruxy-embed trasforma il testo in vettori, cruxy-rerank ordina i candidati rispetto a una query, e cruxy-guard classifica il testo rispetto alle categorie di sicurezza dei contenuti.Cookbook DocumentazioneDisponibileUna guida rapida, una guida per ogni route, un cookbook con retrieval, cicli di strumenti e streaming nel browser, e il riferimento API completo.Leggi la documentazione StatoDisponibileControlli in tempo reale e incidenti, su un dominio a parte, così puoi controllare noi prima di controllare il tuo codice.Vedi lo stato

Chat

Due route, un unico insieme di modelli. Usa quella che il tuo client parla già.

Guida alla chat

POST /v1/chat/completions

Compatibile con OpenAI

Punta qualsiasi client OpenAI o harness di valutazione a https://api.cruxy.ai/v1 con la tua chiave Cruxy. Oggetti chat.completion standard, SSE di OpenAI ed envelope degli errori di OpenAI, con dentro un codice Cruxy stabile.

temperature, top_p, max_tokens e reasoning_effort vengono rispettati
I campi che il gateway non usa vengono ignorati, non rifiutati, così un harness che li invia gira comunque
Un'esecuzione riproducibile dei tuoi messaggi e del modello. Niente memoria, niente casseforti, niente file

POST /api/v1/chat

Chat Cruxy

Gli stessi modelli con tutto ciò che ha l'app Cruxy: richiamo e acquisizione della memoria, casseforti e regole permanenti, file per id, e usage.cost su ogni risposta.

memory: { recall, capture } per richiesta, regole attive o no, un vault_id
usage.cost con la taglia, l'importo e la valuta in ogni risposta
cruxy.request_id per ritrovare la chiamata nei tuoi log e abbinarla al 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

Imposta stream su true e la risposta arriva come server-sent events di OpenAI: frame chat.completion.chunk con delta di contenuto o di tool call, poi [DONE].

Se l'upstream fallisce a metà stream, lo stream termina con un frame di errore invece di [DONE], così il tuo client distingue un'interruzione da una conclusione. Il tool calling funziona su entrambe le route: invia le funzioni che il modello può chiamare, esegui quelle che restituisce e rimanda indietro i risultati.

Guida al tool calling

L'API

Ogni route, una riga ciascuna. I percorsi come li elenca il riferimento.

Riferimento API completo

GRUPPOROUTECOSA FADOCUMENTAZIONE

Chat

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

Chat completions compatibili con OpenAI, la chat propria di Cruxy con memoria, casseforti, regole e file, e un contatore di token.Guida alla chat

Modelli

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

Il catalogo delle taglie, come elenco OpenAI o con i metadati propri di Cruxy: finestra di contesto, prezzi, supporto agli strumenti e impostazioni predefinite di ragionamento.Riferimento modelli

Tool calling

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

Invia le funzioni che il modello può chiamare, esegui le chiamate che restituisce e rimanda indietro i risultati.Guida al tool calling

Embedding e rerank

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

Trasforma il testo in vettori con cruxy-embed e ordina i documenti candidati rispetto a una query con cruxy-rerank.Guida agli embedding

Moderazione

POST /api/v1/moderations

Classifica il testo rispetto alle categorie di sicurezza dei contenuti con cruxy-guard e agisci in base al booleano flagged.Guida alla moderazione

File

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

Carica, elenca, scarica ed elimina file, poi allegali alle richieste chat di Cruxy per id.Riferimento API

Eval

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

Suite di casi che definisci, esecuzioni che avvii, e risultati che rileggi.Riferimento API

Feedback

POST /api/v1/feedback

Segnala l'esito di una chiamata precedente tramite il suo request id: accettazioni, rifiuti, pollici su o giù e risultati dei test.Guida al feedback

Memoria, casseforti e regole

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

Leggi ed elimina memorie, gestisci le casseforti e i loro membri, e imposta regole permanenti per un account o una cassaforte.Riferimento API

Limiti e log

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

I tuoi massimali di richieste per chiave e per organizzazione, e il log delle tue richieste per request id.Riferimento errori

Chiavi e organizzazione

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

Device login per una chiave, i membri e gli inviti della tua organizzazione, e gli spazi di lavoro.Guida all'autenticazione

Gestisci

Limiti, log ed errori su cui puoi ragionare.

Riferimento errori

Limiti che puoi leggere

GET /api/v1/limits restituisce i tuoi massimali di richieste chat per chiave e per organizzazione per ogni finestra di 60 secondi, e il gateway invia gli header X-RateLimit. Non c'è un limite di token al minuto.

Due tipi di 429

rate_limited significa che le richieste arrivano troppo in fretta; si risolve quando rallenti. budget_exhausted è un tetto di spesa che un semplice nuovo tentativo non risolve.

Log per request id

Ogni richiesta è registrata con modello, conteggi di token, costo, tempi e stato, e nulla del prompt o della risposta. Rileggine una su GET /api/v1/logs/{request_id}.

Chiavi mostrate una sola volta

Ottieni una chiave con il flusso di device login. Viene mostrata esattamente una volta e salvata solo come hash. I segreti a riposo sono cifrati campo per campo con AES-256-GCM.

Disponibile

Cruxy Code

Gli stessi modelli, nel tuo terminale.

Pianifica modifiche a più passaggi e mostra ogni diff prima che tu lo approvi
Chiede prima di ogni modifica e di ogni comando, per impostazione predefinita
Esegue il tuo comando di test, legge i fallimenti e continua a correggere
cruxy rollback riporta l'albero dei file a prima di qualsiasi turno
cruxy pr apre la pull request dopo una sola approvazione

npm i -g @cruxy/cliEsplora 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 sessione reale, accorciata. L'output della CLI è reale; le risposte del modello sono illustrative.

Prezzi API

Per token, in USD. Nessun costo di attivazione e nessun minimo.

Prezzi API per intero

Fast· Mira

Chiamate brevi e ad alto volume in cui latenza e costo contano di più.

INPUT: $0.20 / 1M
OUTPUT: $0.40 / 1M

Contesto: 64K
Output massimo: 2K

Balanced· Vaani

Chiamate quotidiane: qualità solida a latenza e costo più bassi.

INPUT: $0.65 / 1M
OUTPUT: $1.30 / 1M

Contesto: 128K
Output massimo: 4K

Deep· Kavi

Le attività più difficili: ragionamento profondo e il budget di output più grande.

INPUT: $0.76 / 1M
OUTPUT: $1.52 / 1M

Contesto: 256K
Output massimo: 8K

USD per 1M di token, conteggiati per richiesta. I prezzi dell'API escludono la GST. Per gli account fatturati in India si aggiunge il 18% di GST (credito d'imposta disponibile). Con auto, paghi la tariffa del modello che ha servito la chiamata.

Domande

Utile da sapere.

Moderazione su qualsiasi chiaveFiltra l'input con cruxy-guard prima che arrivi alla chat. La Moderation API accetta qualsiasi chiave su qualsiasi piano.

Sì, per la chat e l'elenco dei modelli. https://api.cruxy.ai/v1 serve /v1/chat/completions e /v1/models nei formati di OpenAI, così i client e gli harness di valutazione esistenti funzionano una volta cambiati l'URL di base e la chiave. Il resto dell'API, dai file alle eval, è proprio di Cruxy e vive sotto /api/v1.

Cambia l'URL di base. Tieni il tuo codice.

Inizia gratis, paga per token, e leggi ogni limite prima di raggiungerlo.

Inizia gratis Riferimento 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)

Costruisci ciò che viene dopo.

Tutto ciò su cui puoi costruire. Tutto disponibile, tutto documentato.

Due route, un unico insieme di modelli. Usa quella che il tuo client parla già.

Compatibile con OpenAI

Chat Cruxy

Ogni route, una riga ciascuna. I percorsi come li elenca il riferimento.

Limiti, log ed errori su cui puoi ragionare.

Limiti che puoi leggere

Due tipi di 429

Log per request id

Chiavi mostrate una sola volta

Gli stessi modelli, nel tuo terminale.

Per token, in USD. Nessun costo di attivazione e nessun minimo.

Utile da sapere.

L'API è compatibile con OpenAI?

Come ottengo una chiave API?

Quale modello dovrei passare?

Avete un SDK?

I miei dati vengono usati per l'addestramento?

Cambia l'URL di base. Tieni il tuo codice.

Costruisci ciò che viene dopo.

Tutto ciò su cui puoi costruire. Tutto disponibile, tutto documentato.

Due route, un unico insieme di modelli. Usa quella che il tuo client parla già.

Compatibile con OpenAI

Chat Cruxy

Ogni route, una riga ciascuna. I percorsi come li elenca il riferimento.

Limiti, log ed errori su cui puoi ragionare.

Limiti che puoi leggere

Due tipi di 429

Log per request id

Chiavi mostrate una sola volta

Gli stessi modelli, nel tuo terminale.

Per token, in USD. Nessun costo di attivazione e nessun minimo.

Utile da sapere.

L'API è compatibile con OpenAI?

Come ottengo una chiave API?

Quale modello dovrei passare?

Avete un SDK?

I miei dati vengono usati per l'addestramento?

Cambia l'URL di base. Tieni il tuo codice.