Wie bekomme ich einen API-Schlüssel?

Registrieren Sie sich bei Cruxy und erstellen Sie einen Schlüssel über den im Schnellstart beschriebenen Geräte-Login: Fordern Sie einen Gerätecode an, bestätigen Sie ihn im Browser und fragen Sie den Schlüssel ab. API-Schlüssel kommen aus demselben Konto wie die App, und die API wird pro Token abgerechnet, getrennt von Ihrem Tarif.

Welches Modell soll ich übergeben?

Übergeben Sie auto, sofern Sie keinen Grund dagegen haben. Mira ist die Größe Fast für kurze Aufrufe in großen Mengen, Vaani ist der ausgewogene Standard, und Kavi ist die Größe Deep für die schwersten Aufgaben. Das Modell hinter einer Größe kann sich ändern; die Größen-ID ist die Zusage.

Jeder OpenAI-Client funktioniert für Chat Completions und Modelle, in der Sprache, die Sie schon nutzen. Für Cruxys eigene Routen zeigt die Dokumentation die Anfrage in curl und in TypeScript mit fetch.

Werden meine Daten zum Training verwendet?

Ihre Prompts und Ausgaben werden nicht ohne Ihre ausdrückliche, gesonderte Einwilligung zum Training von KI-Modellen verwendet. Die Anfrageprotokolle halten Modell, Token-Zahlen, Kosten und Zeit fest, und nichts vom Inhalt. Die Datenschutzerklärung hat die vollständige Darstellung.

Entwickler

Bauen Sie, was als Nächstes kommt.

Eine Basis-URL, ein Schlüssel und drei Modellgrößen dahinter. Eine OpenAI-kompatible API für Chat, Cruxys eigene Routen, wenn Sie Gedächtnis, Tresore, Dateien und Evals wollen, und eine CLI, die in Ihrem Repo arbeitet.

Kostenlos starten Schnellstart lesen

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
  }
}

Die Anfrage ist echt. Die Antwort ist beispielhaft und auf ihre Form gekürzt.

Basis-URL: api.cruxy.ai/v1
Modelle: kavi · vaani · mira · auto
Streaming: OpenAIs SSE, endet mit [DONE]
Fehler: Ein stabiler Code bei jedem

Die Plattform

Alles, worauf Sie aufbauen können. Alles verfügbar, alles dokumentiert.

Chat APIVerfügbarOpenAI-kompatible Chat Completions auf drei Modellgrößen. Streaming, Tool-Aufrufe und ein reasoning_effort, das Sie pro Anfrage setzen.Chat-Leitfaden Cruxy CodeVerfügbarEin Coding-Agent für Ihr Terminal. Liest Ihre Codebasis, bearbeitet Dateien mit einem Diff vor jeder Freigabe, führt Ihre Tests aus und öffnet Pull Requests.Cruxy Code entdecken Evals APIVerfügbarSuiten aus Fällen, die Sie definieren, Läufe, die Sie starten, Ergebnisse, die Sie abrufen. Richten Sie ein Evaluierungs-Harness auf die OpenAI-kompatiblen Routen, oder nutzen Sie die Evals-Routen direkt.API-Referenz Embeddings, Rerank und ModerationVerfügbarcruxy-embed macht aus Text Vektoren, cruxy-rerank ordnet Kandidaten nach einer Anfrage, und cruxy-guard klassifiziert Text nach Content-Safety-Kategorien.Cookbook DokumentationVerfügbarEin Schnellstart, ein Leitfaden für jede Route, ein Cookbook mit Retrieval, Tool-Schleifen und Streaming im Browser, und die vollständige API-Referenz.Dokumentation lesen StatusVerfügbarLive-Checks und Vorfälle, auf einer eigenen Domain, damit Sie uns prüfen können, bevor Sie Ihren Code prüfen.Status ansehen

Chat

Zwei Routen, ein Satz Modelle. Nutzen Sie die, die Ihr Client schon spricht.

Chat-Leitfaden

POST /v1/chat/completions

OpenAI-kompatibel

Richten Sie jeden OpenAI-Client oder jedes Evaluierungs-Harness mit Ihrem Cruxy-Schlüssel auf https://api.cruxy.ai/v1. Standard-chat.completion-Objekte, OpenAIs SSE und OpenAIs Fehlerformat, mit einem stabilen Cruxy-Code darin.

temperature, top_p, max_tokens und reasoning_effort werden berücksichtigt
Felder, die das Gateway nicht nutzt, werden ignoriert, nicht abgelehnt, sodass ein Harness, das sie sendet, trotzdem läuft
Ein reproduzierbarer Lauf mit Ihren Nachrichten und dem Modell. Kein Gedächtnis, keine Tresore, keine Dateien

POST /api/v1/chat

Cruxy-Chat

Dieselben Modelle mit allem, was die Cruxy-App hat: Abruf und Erfassung von Erinnerungen, Tresore und feste Regeln, Dateien per ID und usage.cost bei jeder Antwort.

memory: { recall, capture } pro Anfrage, Regeln an oder aus, eine vault_id
usage.cost mit Stufe, Betrag und Währung bei jeder Antwort
cruxy.request_id, um den Aufruf in Ihren Logs nachzuschlagen und mit Feedback zu verknüpfen

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

Setzen Sie stream auf true, und die Antwort kommt als OpenAIs Server-Sent Events: chat.completion.chunk-Frames mit Deltas für Inhalt oder Tool-Aufrufe, dann [DONE].

Fällt das Upstream-System mitten im Stream aus, endet der Stream mit einem Fehler-Frame statt mit [DONE], sodass Ihr Client einen Abbruch von einem Ende unterscheiden kann. Tool-Aufrufe funktionieren auf beiden Routen: Senden Sie die Funktionen, die das Modell aufrufen darf, führen Sie die aus, die es zurückgibt, und geben Sie die Ergebnisse zurück.

Leitfaden zu Tool-Aufrufen

Die API

Jede Route, je eine Zeile. Pfade, wie die Referenz sie auflistet.

Vollständige API-Referenz

GRUPPEROUTENWAS SIE TUTDOKUMENTATION

Chat

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

OpenAI-kompatible Chat Completions, Cruxys eigener Chat mit Gedächtnis, Tresoren, Regeln und Dateien, und ein Token-Zähler.Chat-Leitfaden

Modelle

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

Der Stufenkatalog, als OpenAI-Liste oder mit Cruxys eigenen Metadaten: Kontextfenster, Preise, Tool-Unterstützung und Reasoning-Standardwerte.Modellreferenz

Tool-Aufrufe

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

Senden Sie die Funktionen, die das Modell aufrufen darf, führen Sie die Aufrufe aus, die es zurückgibt, und geben Sie die Ergebnisse zurück.Leitfaden zu Tool-Aufrufen

Embeddings und Rerank

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

Machen Sie mit cruxy-embed aus Text Vektoren und ordnen Sie mit cruxy-rerank Kandidatendokumente nach einer Anfrage.Embeddings-Leitfaden

Moderation

POST /api/v1/moderations

Klassifizieren Sie Text mit cruxy-guard nach Content-Safety-Kategorien und handeln Sie anhand des booleschen Werts flagged.Moderations-Leitfaden

Dateien

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

Laden Sie Dateien hoch, listen Sie sie auf, laden Sie sie herunter und löschen Sie sie, und hängen Sie sie dann per ID an Cruxy-Chat-Anfragen an.API-Referenz

Evals

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

Suiten aus Fällen, die Sie definieren, Läufe, die Sie starten, und Ergebnisse, die Sie abrufen.API-Referenz

Feedback

POST /api/v1/feedback

Melden Sie das Ergebnis eines früheren Aufrufs über seine Anfrage-ID: Annahmen, Ablehnungen, Daumen und Testergebnisse.Feedback-Leitfaden

Gedächtnis, Tresore und Regeln

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

Lesen und löschen Sie Erinnerungen, verwalten Sie Tresore und ihre Mitglieder und setzen Sie feste Regeln für ein Konto oder einen Tresor.API-Referenz

Limits und Logs

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

Ihre Anfrageobergrenzen pro Schlüssel und pro Organisation, und das Protokoll Ihrer Anfragen nach Anfrage-ID.Fehlerreferenz

Schlüssel und Organisation

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

Geräte-Login für einen Schlüssel, die Mitglieder und Einladungen Ihrer Organisation, und Arbeitsbereiche.Authentifizierungs-Leitfaden

Betrieb

Limits, Logs und Fehler, die Sie nachvollziehen können.

Fehlerreferenz

Limits, die Sie auslesen können

GET /api/v1/limits liefert Ihre Obergrenzen für Chat-Anfragen pro Schlüssel und pro Organisation für jedes 60-Sekunden-Fenster, und das Gateway sendet X-RateLimit-Header. Ein Limit für Token pro Minute gibt es nicht.

Zwei Arten von 429

rate_limited bedeutet, dass Anfragen zu schnell eintreffen; es verschwindet, sobald Sie langsamer werden. budget_exhausted ist eine Ausgabenobergrenze, die ein Wiederholen allein nicht aufhebt.

Logs nach Anfrage-ID

Jede Anfrage wird mit Modell, Token-Zahlen, Kosten, Zeit und Status protokolliert, und nichts vom Prompt oder der Antwort. Lesen Sie eine unter GET /api/v1/logs/{request_id} zurück.

Schlüssel einmal gezeigt

Holen Sie sich einen Schlüssel über den Geräte-Login. Er wird genau einmal gezeigt und nur als Hash gespeichert. Secrets im Ruhezustand sind Feld für Feld mit AES-256-GCM verschlüsselt.

Verfügbar

Cruxy Code

Dieselben Modelle, in Ihrem Terminal.

Plant mehrstufige Änderungen und zeigt jedes Diff, bevor Sie es freigeben
Fragt standardmäßig vor jeder Bearbeitung und jedem Befehl
Führt Ihren Testbefehl aus, liest die Fehler und behebt sie weiter
cruxy rollback stellt den Dateibaum auf den Stand vor einem beliebigen Schritt zurück
cruxy pr öffnet den Pull Request nach einer Freigabe

npm i -g @cruxy/cliCruxy Code entdecken

~/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)

Eine echte Sitzung, gekürzt. Die CLI-Ausgabe ist echt; die Antworten des Modells sind beispielhaft.

API-Preise

Pro Token, in USD. Keine Einrichtungsgebühr und kein Mindestumsatz.

API-Preise im Detail

Fast· Mira

Kurze Aufrufe in großen Mengen, bei denen Latenz und Kosten am meisten zählen.

EINGABE: $0.20 / 1M
AUSGABE: $0.40 / 1M

Kontext: 64K
Max. Ausgabe: 2K

Balanced· Vaani

Alltägliche Aufrufe: starke Qualität bei niedrigerer Latenz und niedrigeren Kosten.

EINGABE: $0.65 / 1M
AUSGABE: $1.30 / 1M

Kontext: 128K
Max. Ausgabe: 4K

Deep· Kavi

Die schwersten Aufgaben: tiefes Reasoning und das größte Ausgabebudget.

EINGABE: $0.76 / 1M
AUSGABE: $1.52 / 1M

Kontext: 256K
Max. Ausgabe: 8K

USD pro 1M Token, pro Anfrage abgerechnet. API-Preise verstehen sich ohne GST. Für in Indien abgerechnete Konten kommen 18% GST hinzu (Vorsteuerabzug möglich). Mit auto zahlen Sie den Preis des Modells, das den Aufruf bedient hat.

Fragen

Gut zu wissen.

Moderation mit jedem SchlüsselPrüfen Sie Eingaben mit cruxy-guard, bevor sie den Chat erreichen. Die Moderation API funktioniert mit jedem Schlüssel in jedem Tarif.

Ja, für Chat und die Modellliste. https://api.cruxy.ai/v1 bedient /v1/chat/completions und /v1/models in OpenAIs Formaten, sodass vorhandene Clients und Evaluierungs-Harnesses funktionieren, sobald Sie Basis-URL und Schlüssel ändern. Der Rest der API, von Dateien bis Evals, ist Cruxys eigener und liegt unter /api/v1.

Ändern Sie die Basis-URL. Behalten Sie Ihren Code.

Starten Sie kostenlos, zahlen Sie pro Token und lesen Sie jedes Limit, bevor Sie es erreichen.

Kostenlos starten API-Referenz

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)

Bauen Sie, was als Nächstes kommt.

Alles, worauf Sie aufbauen können. Alles verfügbar, alles dokumentiert.

Zwei Routen, ein Satz Modelle. Nutzen Sie die, die Ihr Client schon spricht.

OpenAI-kompatibel

Cruxy-Chat

Jede Route, je eine Zeile. Pfade, wie die Referenz sie auflistet.

Limits, Logs und Fehler, die Sie nachvollziehen können.

Limits, die Sie auslesen können

Zwei Arten von 429

Logs nach Anfrage-ID

Schlüssel einmal gezeigt

Dieselben Modelle, in Ihrem Terminal.

Pro Token, in USD. Keine Einrichtungsgebühr und kein Mindestumsatz.

Gut zu wissen.

Ist die API OpenAI-kompatibel?

Wie bekomme ich einen API-Schlüssel?

Welches Modell soll ich übergeben?

Gibt es ein SDK?

Werden meine Daten zum Training verwendet?

Ändern Sie die Basis-URL. Behalten Sie Ihren Code.

Bauen Sie, was als Nächstes kommt.

Alles, worauf Sie aufbauen können. Alles verfügbar, alles dokumentiert.

Zwei Routen, ein Satz Modelle. Nutzen Sie die, die Ihr Client schon spricht.

OpenAI-kompatibel

Cruxy-Chat

Jede Route, je eine Zeile. Pfade, wie die Referenz sie auflistet.

Limits, Logs und Fehler, die Sie nachvollziehen können.

Limits, die Sie auslesen können

Zwei Arten von 429

Logs nach Anfrage-ID

Schlüssel einmal gezeigt

Dieselben Modelle, in Ihrem Terminal.

Pro Token, in USD. Keine Einrichtungsgebühr und kein Mindestumsatz.

Gut zu wissen.

Ist die API OpenAI-kompatibel?

Wie bekomme ich einen API-Schlüssel?

Welches Modell soll ich übergeben?

Gibt es ein SDK?

Werden meine Daten zum Training verwendet?

Ändern Sie die Basis-URL. Behalten Sie Ihren Code.