Comment obtenir une clé API ?

Inscrivez-vous à Cruxy et créez une clé avec le flux de connexion d'appareil décrit dans le guide de démarrage : demandez un code d'appareil, approuvez-le dans le navigateur et interrogez périodiquement pour récupérer la clé. Les clés API viennent du même compte que l'application, et l'API est facturée par token, séparément de votre forfait.

Quel modèle dois-je passer ?

Passez auto sauf si vous avez une raison de ne pas le faire. Mira est la taille Fast pour les appels courts et à haut volume, Vaani est le choix Balanced par défaut, et Kavi est la taille Deep pour les tâches les plus difficiles. Le modèle derrière une taille peut changer ; l'identifiant de la taille est le contrat.

N'importe quel client OpenAI fonctionne pour les chat completions et les modèles, dans le langage que vous utilisez déjà. Pour les routes propres à Cruxy, la documentation montre la requête en curl et en TypeScript avec fetch.

Mes données servent-elles à l'entraînement ?

Vos prompts et vos sorties ne servent pas à entraîner des modèles d'IA sans votre consentement explicite et distinct. Les journaux de requêtes gardent le modèle, le nombre de tokens, le coût et la durée, et rien du contenu. La politique de confidentialité donne le détail complet.

Développeurs

Construisez ce qui vient.

Une seule URL de base, une seule clé et trois tailles de modèle derrière. Une API compatible OpenAI pour le chat, les routes propres à Cruxy quand vous voulez la mémoire, les coffres, les fichiers et les evals, et une CLI qui travaille dans votre dépôt.

Commencer gratuitement Lire le guide de démarrage

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 requête est réelle. La réponse est illustrative et réduite à sa forme.

URL de base: api.cruxy.ai/v1
Modèles: kavi · vaani · mira · auto
Streaming: Les SSE d'OpenAI, terminés par [DONE]
Erreurs: Un code stable sur chacune

La plateforme

Tout ce sur quoi vous pouvez développer. Tout est disponible, tout est documenté.

API de chatDisponibleDes chat completions compatibles OpenAI sur trois tailles de modèle. Streaming, appel d'outils et un reasoning_effort que vous réglez par requête.Guide du chat Cruxy CodeDisponibleUn agent de codage pour votre terminal. Lit votre base de code, modifie des fichiers avec un diff avant chaque approbation, exécute vos tests et ouvre des pull requests.Découvrir Cruxy Code Evals APIDisponibleDes suites de cas que vous définissez, des exécutions que vous lancez, des résultats que vous relisez. Pointez un harnais d'évaluation sur les routes compatibles OpenAI, ou utilisez directement les routes evals.Référence de l'API Embeddings, rerank et modérationDisponiblecruxy-embed transforme du texte en vecteurs, cruxy-rerank ordonne des candidats par rapport à une requête, et cruxy-guard classe du texte selon des catégories de sécurité du contenu.Cookbook DocumentationDisponibleUn guide de démarrage, un guide pour chaque route, un cookbook avec la récupération, les boucles d'outils et le streaming dans le navigateur, et la référence complète de l'API.Lire la documentation StatutDisponibleSondes en direct et incidents, sur leur propre domaine, pour nous vérifier avant de vérifier votre code.Voir le statut

Chat

Deux routes, un seul jeu de modèles. Utilisez celle que votre client parle déjà.

Guide du chat

POST /v1/chat/completions

Compatible OpenAI

Pointez n'importe quel client OpenAI ou harnais d'évaluation sur https://api.cruxy.ai/v1 avec votre clé Cruxy. Des objets chat.completion standard, les SSE d'OpenAI et l'enveloppe d'erreur d'OpenAI, avec un code Cruxy stable à l'intérieur.

temperature, top_p, max_tokens et reasoning_effort sont respectés
Les champs que la passerelle n'utilise pas sont ignorés, pas refusés, donc un harnais qui les envoie tourne quand même
Une exécution reproductible de vos messages et du modèle. Pas de mémoire, pas de coffres, pas de fichiers

POST /api/v1/chat

Chat Cruxy

Les mêmes modèles avec tout ce que l'application Cruxy a : rappel et capture de la mémoire, coffres et règles permanentes, fichiers par identifiant, et usage.cost sur chaque réponse.

memory: { recall, capture } par requête, règles activées ou non, un vault_id
usage.cost avec la taille, le montant et la devise sur chaque réponse
cruxy.request_id pour retrouver l'appel dans vos journaux et l'associer à un 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

Réglez stream sur true et la réponse arrive sous forme de server-sent events d'OpenAI : des trames chat.completion.chunk avec des deltas de contenu ou d'appel d'outil, puis [DONE].

Si l'amont échoue en cours de flux, le flux se termine par une trame d'erreur au lieu de [DONE], pour que votre client distingue une coupure d'une fin. L'appel d'outils fonctionne sur les deux routes : envoyez les fonctions que le modèle peut appeler, exécutez celles qu'il renvoie et renvoyez-lui les résultats.

Guide de l'appel d'outils

L'API

Chaque route, une ligne chacune. Les chemins tels que la référence les liste.

Référence complète de l'API

GROUPEROUTESCE QU'ELLE FAITDOCUMENTATION

Chat

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

Des chat completions compatibles OpenAI, le chat propre à Cruxy avec mémoire, coffres, règles et fichiers, et un compteur de tokens.Guide du chat

Modèles

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

Le catalogue des tailles, en liste OpenAI ou avec les métadonnées propres à Cruxy : fenêtre de contexte, tarifs, prise en charge des outils et réglages de raisonnement par défaut.Référence des modèles

Appel d'outils

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

Envoyez les fonctions que le modèle peut appeler, exécutez les appels qu'il renvoie et renvoyez-lui les résultats.Guide de l'appel d'outils

Embeddings et rerank

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

Transformez du texte en vecteurs avec cruxy-embed et ordonnez des documents candidats par rapport à une requête avec cruxy-rerank.Guide des embeddings

Modération

POST /api/v1/moderations

Classez du texte selon des catégories de sécurité du contenu avec cruxy-guard et agissez sur le booléen flagged.Guide de modération

Fichiers

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

Téléversez, listez, téléchargez et supprimez des fichiers, puis joignez-les aux requêtes de chat Cruxy par identifiant.Référence de l'API

Evals

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

Des suites de cas que vous définissez, des exécutions que vous lancez, et des résultats que vous relisez.Référence de l'API

Feedback

POST /api/v1/feedback

Signalez le résultat d'un appel précédent par son identifiant de requête : acceptations, rejets, pouces et résultats de tests.Guide du feedback

Mémoire, coffres et règles

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

Lisez et supprimez des souvenirs, gérez les coffres et leurs membres, et définissez des règles permanentes pour un compte ou un coffre.Référence de l'API

Limites et journaux

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

Vos plafonds de requêtes par clé et par organisation, et le journal de vos requêtes par identifiant de requête.Référence des erreurs

Clés et organisation

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

Connexion d'appareil pour une clé, les membres et les invitations de votre organisation, et les espaces de travail.Guide d'authentification

Exploiter

Des limites, des journaux et des erreurs sur lesquels vous pouvez raisonner.

Référence des erreurs

Des limites que vous pouvez lire

GET /api/v1/limits renvoie vos plafonds de requêtes de chat par clé et par organisation pour chaque fenêtre de 60 secondes, et la passerelle envoie des en-têtes X-RateLimit. Il n'y a pas de limite de tokens par minute.

Deux sortes de 429

rate_limited signifie que les requêtes arrivent trop vite ; cela disparaît dès que vous ralentissez. budget_exhausted est un plafond de dépenses qu'une simple nouvelle tentative ne lèvera pas.

Des journaux par identifiant de requête

Chaque requête est journalisée avec le modèle, le nombre de tokens, le coût, la durée et le statut, et rien du prompt ni de la réponse. Relisez-en une sur GET /api/v1/logs/{request_id}.

Des clés montrées une seule fois

Obtenez une clé avec le flux de connexion d'appareil. Elle est montrée exactement une fois et stockée uniquement sous forme de haché. Les secrets au repos sont chiffrés champ par champ avec AES-256-GCM.

Disponible

Cruxy Code

Les mêmes modèles, dans votre terminal.

Planifie des modifications en plusieurs étapes et montre chaque diff avant que vous l'approuviez
Demande avant chaque modification et chaque commande, par défaut
Lance votre commande de test, lit les échecs et continue de corriger
cruxy rollback ramène l'arborescence à l'état d'avant n'importe quel tour
cruxy pr ouvre la pull request après une seule approbation

npm i -g @cruxy/cliDécouvrir 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)

Une vraie session, coupée court. La sortie de la CLI est réelle ; les réponses du modèle sont illustratives.

Tarifs de l'API

Par token, en USD. Sans frais d'installation et sans minimum.

Tarifs de l'API en détail

Fast· Mira

Des appels courts et à haut volume où la latence et le coût comptent le plus.

ENTRÉE: $0.20 / 1M
SORTIE: $0.40 / 1M

Contexte: 64K
Sortie max: 2K

Balanced· Vaani

Les appels de tous les jours : une qualité solide à latence et coût réduits.

ENTRÉE: $0.65 / 1M
SORTIE: $1.30 / 1M

Contexte: 128K
Sortie max: 4K

Deep· Kavi

Les tâches les plus difficiles : raisonnement profond et le plus grand budget de sortie.

ENTRÉE: $0.76 / 1M
SORTIE: $1.52 / 1M

Contexte: 256K
Sortie max: 8K

USD par 1M tokens, mesurés par requête. Les prix de l'API sont hors GST. Une GST de 18 % est ajoutée pour les comptes facturés en Inde (crédit de taxe sur les intrants disponible). Avec auto, vous payez le tarif du modèle qui a servi l'appel.

Questions

Bon à savoir.

Modération avec n'importe quelle cléFiltrez l'entrée avec cruxy-guard avant qu'elle n'atteigne le chat. L'API de modération accepte n'importe quelle clé sur n'importe quel forfait.

Oui, pour le chat et la liste des modèles. https://api.cruxy.ai/v1 sert /v1/chat/completions et /v1/models dans les formats d'OpenAI, donc les clients et harnais d'évaluation existants fonctionnent une fois l'URL de base et la clé changées. Le reste de l'API, des fichiers aux evals, est propre à Cruxy et vit sous /api/v1.

Changez l'URL de base. Gardez votre code.

Commencez gratuitement, payez par token, et lisez chaque limite avant de l'atteindre.

Commencer gratuitement Référence de l'API

Construisez ce qui vient.

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)

Construisez ce qui vient.

Tout ce sur quoi vous pouvez développer. Tout est disponible, tout est documenté.

Deux routes, un seul jeu de modèles. Utilisez celle que votre client parle déjà.

Compatible OpenAI

Chat Cruxy

Chaque route, une ligne chacune. Les chemins tels que la référence les liste.

Des limites, des journaux et des erreurs sur lesquels vous pouvez raisonner.

Des limites que vous pouvez lire

Deux sortes de 429

Des journaux par identifiant de requête

Des clés montrées une seule fois

Les mêmes modèles, dans votre terminal.

Par token, en USD. Sans frais d'installation et sans minimum.

Bon à savoir.

L'API est-elle compatible OpenAI ?

Comment obtenir une clé API ?

Quel modèle dois-je passer ?

Avez-vous un SDK ?

Mes données servent-elles à l'entraînement ?

Changez l'URL de base. Gardez votre code.

Construisez ce qui vient.

Tout ce sur quoi vous pouvez développer. Tout est disponible, tout est documenté.

Deux routes, un seul jeu de modèles. Utilisez celle que votre client parle déjà.

Compatible OpenAI

Chat Cruxy

Chaque route, une ligne chacune. Les chemins tels que la référence les liste.

Des limites, des journaux et des erreurs sur lesquels vous pouvez raisonner.

Des limites que vous pouvez lire

Deux sortes de 429

Des journaux par identifiant de requête

Des clés montrées une seule fois

Les mêmes modèles, dans votre terminal.

Par token, en USD. Sans frais d'installation et sans minimum.

Bon à savoir.

L'API est-elle compatible OpenAI ?

Comment obtenir une clé API ?

Quel modèle dois-je passer ?

Avez-vous un SDK ?

Mes données servent-elles à l'entraînement ?

Changez l'URL de base. Gardez votre code.