API anahtarını nasıl alırım?

Cruxy'ye kaydolun ve hızlı başlangıçta anlatılan cihaz girişi akışıyla bir anahtar oluşturun: bir cihaz kodu isteyin, tarayıcıda onaylayın ve anahtar için yoklayın. API anahtarları uygulamayla aynı hesaptan gelir ve API, planınızdan ayrı olarak token başına faturalandırılır.

Hangi modeli geçirmeliyim?

Aksini gerektiren bir nedeniniz yoksa auto geçirin. Mira kısa, yüksek hacimli çağrılar için hızlı boyut, Vaani dengeli varsayılan ve Kavi en zor görevler için derin boyuttur. Bir boyutun arkasındaki model değişebilir; boyut kimliği sözleşmedir.

Chat completions ve models için, zaten kullandığınız dilde herhangi bir OpenAI istemcisi çalışır. Cruxy'nin kendi rotaları için belgeler isteği curl ile ve fetch kullanan TypeScript ile gösterir.

Verilerim eğitim için kullanılıyor mu?

Prompt'larınız ve çıktılarınız, açık ve ayrı onayınız olmadan yapay zeka modellerini eğitmek için kullanılmaz. İstek log kayıtları modeli, token sayılarını, maliyeti ve zamanlamayı saklar; içeriğin hiçbir kısmını saklamaz. Tam açıklama gizlilik politikasında yer alır.

Geliştiriciler

Geleceği inşa edin.

Tek bir temel URL, tek bir anahtar ve arkasında üç model boyutu. Sohbet için OpenAI uyumlu bir API, bellek, kasalar, dosyalar ve değerlendirmeler istediğinizde Cruxy'nin kendi rotaları ve reponuzda çalışan bir CLI.

Ücretsiz başlayın Hızlı başlangıcı okuyun

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

İstek gerçektir. Yanıt örnek amaçlıdır ve biçimini gösterecek şekilde kısaltılmıştır.

Temel URL: api.cruxy.ai/v1
Modeller: kavi · vaani · mira · auto
Streaming: OpenAI'ın SSE'si, [DONE] ile biter
Hatalar: Her birinde kararlı bir kod

Platform

Üzerine geliştirebileceğiniz her şey. Hepsi kullanımda, hepsi belgelenmiş.

Chat APIKullanımdaÜç model boyutunda OpenAI uyumlu chat completions. Streaming, araç çağırma ve istek başına ayarladığınız bir reasoning_effort.Sohbet rehberi Cruxy CodeKullanımdaTerminaliniz için bir kodlama ajanı. Kod tabanınızı okur, her onaydan önce diff göstererek dosyaları düzenler, testlerinizi çalıştırır ve pull request açar.Cruxy Code'u keşfedin Evals APIKullanımdaTanımladığınız vaka paketleri, başlattığınız çalıştırmalar, geri okuduğunuz sonuçlar. Bir değerlendirme düzeneğini OpenAI uyumlu rotalara yönlendirin ya da evals rotalarını doğrudan kullanın.API referansı Embedding, rerank ve moderasyonKullanımdacruxy-embed metni vektörlere dönüştürür, cruxy-rerank adayları bir sorguya göre sıralar ve cruxy-guard metni içerik güvenliği kategorilerine göre sınıflandırır.Cookbook BelgelerKullanımdaBir hızlı başlangıç, her rota için bir rehber, retrieval, araç döngüleri ve tarayıcıda streaming içeren bir cookbook ve tam API referansı.Belgeleri okuyun DurumKullanımdaCanlı kontroller ve olaylar, kendi alan adında; böylece kodunuzu kontrol etmeden önce bizi kontrol edebilirsiniz.Durumu görün

Sohbet

İki rota, tek bir model kümesi. İstemcinizin zaten konuştuğunu kullanın.

Sohbet rehberi

POST /v1/chat/completions

OpenAI uyumlu

Herhangi bir OpenAI istemcisini veya değerlendirme düzeneğini Cruxy anahtarınızla https://api.cruxy.ai/v1 adresine yönlendirin. Standart chat.completion nesneleri, OpenAI'ın SSE'si ve içinde kararlı bir Cruxy kodu bulunan OpenAI'ın hata zarfı.

temperature, top_p, max_tokens ve reasoning_effort dikkate alınır
Ağ geçidinin kullanmadığı alanlar reddedilmez, yok sayılır; böylece onları gönderen bir düzenek yine çalışır
Mesajlarınızın ve modelin yeniden üretilebilir bir çalıştırması. Bellek yok, kasa yok, dosya yok

POST /api/v1/chat

Cruxy sohbeti

Aynı modeller, Cruxy uygulamasındaki her şeyle birlikte: bellek hatırlama ve yakalama, kasalar ve kalıcı kurallar, kimliğine göre dosyalar ve her yanıtta usage.cost.

İstek başına memory: { recall, capture }, kurallar açık veya kapalı, bir vault_id
Her yanıtta katman, tutar ve para birimiyle usage.cost
Çağrıyı log kayıtlarınızda bulmak ve geri bildirimle eşleştirmek için cruxy.request_id

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

stream değerini true yapın; yanıt OpenAI'ın server-sent events biçiminde gelir: content veya tool-call deltaları içeren chat.completion.chunk çerçeveleri, ardından [DONE].

Upstream akışın ortasında başarısız olursa akış, [DONE] yerine bir hata çerçevesiyle biter; böylece istemciniz kesintiyi bitişten ayırt edebilir. Araç çağırma her iki rotada da çalışır: modelin çağırabileceği fonksiyonları gönderin, döndürdüklerini çalıştırın ve sonuçları geri verin.

Araç çağırma rehberi

API

Her rota, her biri tek satırda. Yollar, referansın listelediği gibi.

Tam API referansı

GRUPROTALARNE YAPARBELGELER

Sohbet

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

OpenAI uyumlu chat completions, bellek, kasalar, kurallar ve dosyalarla Cruxy'nin kendi sohbeti ve bir token sayacı.Sohbet rehberi

Modeller

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

Katman kataloğu, OpenAI listesi olarak ya da Cruxy'nin kendi meta verileriyle: bağlam penceresi, fiyatlandırma, araç desteği ve akıl yürütme varsayılanları.Model referansı

Araç çağırma

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

Modelin çağırabileceği fonksiyonları gönderin, döndürdüğü çağrıları çalıştırın ve sonuçları geri verin.Araç çağırma rehberi

Embedding ve rerank

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

cruxy-embed ile metni vektörlere dönüştürün ve cruxy-rerank ile aday belgeleri bir sorguya göre sıralayın.Embedding rehberi

Moderasyon

POST /api/v1/moderations

cruxy-guard ile metni içerik güvenliği kategorilerine göre sınıflandırın ve flagged boolean değerine göre hareket edin.Moderasyon rehberi

Dosyalar

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

Dosyaları yükleyin, listeleyin, indirin ve silin, ardından kimliğiyle Cruxy sohbet isteklerine ekleyin.API referansı

Değerlendirmeler

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

Tanımladığınız vaka paketleri, başlattığınız çalıştırmalar ve geri okuduğunuz sonuçlar.API referansı

Geri bildirim

POST /api/v1/feedback

Önceki bir çağrının sonucunu istek kimliğiyle bildirin: kabuller, retler, beğeni oyları ve test sonuçları.Geri bildirim rehberi

Bellek, kasalar ve kurallar

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

Bellek kayıtlarını okuyun ve silin, kasaları ve üyelerini yönetin ve bir hesap veya kasa için kalıcı kurallar belirleyin.API referansı

Limitler ve log kayıtları

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

Anahtar başına ve kuruluş başına istek tavanlarınız ve isteklerinizin istek kimliğine göre log kaydı.Hata referansı

Anahtarlar ve kuruluş

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

Anahtar için cihaz girişi, kuruluşunuzun üyeleri ve davetleri ve çalışma alanları.Kimlik doğrulama rehberi

İşletme

Üzerine akıl yürütebileceğiniz limitler, log kayıtları ve hatalar.

Hata referansı

Okuyabileceğiniz limitler

GET /api/v1/limits, her 60 saniyelik pencere için anahtar başına ve kuruluş başına sohbet isteği tavanlarınızı döndürür ve ağ geçidi X-RateLimit başlıklarını gönderir. Dakika başına token limiti yoktur.

İki tür 429

rate_limited, isteklerin çok hızlı geldiği anlamına gelir; yavaşladığınızda kalkar. budget_exhausted, tek başına yeniden denemenin kaldırmayacağı bir harcama tavanıdır.

İstek kimliğine göre log kayıtları

Her istek model, token sayıları, maliyet, zamanlama ve durumla loglanır; prompt ya da yanıtın hiçbir kısmı loglanmaz. Birini GET /api/v1/logs/{request_id} ile geri okuyun.

Anahtarlar bir kez gösterilir

Cihaz girişi akışıyla bir anahtar alın. Tam olarak bir kez gösterilir ve yalnızca hash olarak saklanır. Depolanan gizli bilgiler AES-256-GCM ile alan alan şifrelenir.

Kullanımda

Cruxy Code

Aynı modeller, terminalinizde.

Çok adımlı değişiklikler planlar ve onaylamanızdan önce her diff'i gösterir
Varsayılan olarak her düzenlemeden ve her komuttan önce izin ister
Test komutunuzu çalıştırır, hataları okur ve düzeltmeye devam eder
cruxy rollback çalışma ağacını herhangi bir turdan öncesine döndürür
cruxy pr tek bir onayla pull request'i açar

npm i -g @cruxy/cliCruxy Code'u keşfedin

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

Gerçek bir oturum, kısa kesilmiş. CLI çıktısı gerçektir; modelin yanıtları örnek amaçlıdır.

API fiyatlandırması

Token başına, USD cinsinden. Kurulum ücreti ve asgari tutar yok.

API fiyatlandırması, eksiksiz

Fast· Mira

Gecikmenin ve maliyetin en önemli olduğu kısa, yüksek hacimli çağrılar.

GİRDİ: $0.20 / 1M
ÇIKTI: $0.40 / 1M

Bağlam: 64K
Maksimum çıktı: 2K

Balanced· Vaani

Günlük çağrılar: daha düşük gecikme ve maliyetle güçlü kalite.

GİRDİ: $0.65 / 1M
ÇIKTI: $1.30 / 1M

Bağlam: 128K
Maksimum çıktı: 4K

Deep· Kavi

En zor görevler: derin akıl yürütme ve en büyük çıktı bütçesi.

GİRDİ: $0.76 / 1M
ÇIKTI: $1.52 / 1M

Bağlam: 256K
Maksimum çıktı: 8K

1M token başına USD, istek başına ölçülür. API fiyatlarına GST dahil değildir. Hindistan'da faturalandırılan hesaplara %18 GST eklenir (girdi vergisi indirimi kullanılabilir). auto ile, çağrıya hizmet veren modelin ücretini ödersiniz.

Sorular

Bilmekte fayda var.

Her anahtarda moderasyonGirdiyi sohbete ulaşmadan önce cruxy-guard ile tarayın. Moderasyon API'si her plandaki her anahtarla çalışır.

Evet, sohbet ve model listesi için. https://api.cruxy.ai/v1, /v1/chat/completions ve /v1/models rotalarını OpenAI'ın biçimlerinde sunar; böylece mevcut istemciler ve değerlendirme düzenekleri, temel URL'yi ve anahtarı değiştirdiğinizde çalışır. API'nin geri kalanı, dosyalardan değerlendirmelere, Cruxy'nin kendisine aittir ve /api/v1 altında yer alır.

Temel URL'yi değiştirin. Kodunuz aynı kalsın.

Ücretsiz başlayın, token başına ödeyin ve her limiti ona takılmadan önce okuyun.

Ücretsiz başlayın API referansı

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)

Geleceği inşa edin.

Üzerine geliştirebileceğiniz her şey. Hepsi kullanımda, hepsi belgelenmiş.

İki rota, tek bir model kümesi. İstemcinizin zaten konuştuğunu kullanın.

OpenAI uyumlu

Cruxy sohbeti

Her rota, her biri tek satırda. Yollar, referansın listelediği gibi.

Üzerine akıl yürütebileceğiniz limitler, log kayıtları ve hatalar.

Okuyabileceğiniz limitler

İki tür 429

İstek kimliğine göre log kayıtları

Anahtarlar bir kez gösterilir

Aynı modeller, terminalinizde.

Token başına, USD cinsinden. Kurulum ücreti ve asgari tutar yok.

Bilmekte fayda var.

API OpenAI uyumlu mu?

API anahtarını nasıl alırım?

Hangi modeli geçirmeliyim?

SDK'nız var mı?

Verilerim eğitim için kullanılıyor mu?

Temel URL'yi değiştirin. Kodunuz aynı kalsın.

Geleceği inşa edin.

Üzerine geliştirebileceğiniz her şey. Hepsi kullanımda, hepsi belgelenmiş.

İki rota, tek bir model kümesi. İstemcinizin zaten konuştuğunu kullanın.

OpenAI uyumlu

Cruxy sohbeti

Her rota, her biri tek satırda. Yollar, referansın listelediği gibi.

Üzerine akıl yürütebileceğiniz limitler, log kayıtları ve hatalar.

Okuyabileceğiniz limitler

İki tür 429

İstek kimliğine göre log kayıtları

Anahtarlar bir kez gösterilir

Aynı modeller, terminalinizde.

Token başına, USD cinsinden. Kurulum ücreti ve asgari tutar yok.

Bilmekte fayda var.

API OpenAI uyumlu mu?

API anahtarını nasıl alırım?

Hangi modeli geçirmeliyim?

SDK'nız var mı?

Verilerim eğitim için kullanılıyor mu?

Temel URL'yi değiştirin. Kodunuz aynı kalsın.