Como obtenho uma chave de API?

Cadastre-se na Cruxy e crie uma chave com o fluxo de login por dispositivo descrito no guia de início rápido: solicite um código de dispositivo, aprove no navegador e consulte até receber a chave. As chaves de API vêm da mesma conta do app, e a API é cobrada por token, separadamente do seu plano.

Qual modelo devo passar?

Passe auto, a menos que tenha um motivo para não passar. Mira é o tamanho fast para chamadas curtas e de alto volume, Vaani é o padrão balanced, e Kavi é o tamanho deep para as tarefas mais difíceis. O modelo por trás de um tamanho pode mudar; o id do tamanho é o contrato.

Qualquer cliente OpenAI funciona para chat completions e models, na linguagem que você já usa. Para as rotas próprias da Cruxy, a documentação mostra a requisição em curl e em TypeScript com fetch.

Meus dados são usados para treinamento?

Seus prompts e saídas não são usados para treinar modelos de IA sem o seu consentimento explícito e separado. Os registros de requisição guardam o modelo, as contagens de tokens, o custo e o tempo, e nada do conteúdo. A política de privacidade tem o relato completo.

Desenvolvedores

Construa o que vem a seguir.

Uma URL base, uma chave e três tamanhos de modelo por trás dela. Uma API compatível com a OpenAI para chat, as rotas próprias da Cruxy quando você quiser memória, cofres, arquivos e evals, e uma CLI que trabalha no seu repositório.

Comece grátis Leia o guia de início 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
  }
}

A requisição é real. A resposta é ilustrativa e cortada para mostrar só a forma.

URL base: api.cruxy.ai/v1
Modelos: kavi · vaani · mira · auto
Streaming: SSE da OpenAI, termina com [DONE]
Erros: Um código estável em cada um

A plataforma

Tudo sobre o que você pode construir. Tudo disponível, tudo documentado.

API de chatDisponívelChat completions compatíveis com a OpenAI em três tamanhos de modelo. Streaming, chamada de ferramentas e um reasoning_effort que você define por requisição.Guia de chat Cruxy CodeDisponívelUm agente de programação para o seu terminal. Lê sua base de código, edita arquivos com um diff antes de cada aprovação, roda seus testes e abre pull requests.Explorar o Cruxy Code Evals APIDisponívelSuítes de casos que você define, execuções que você inicia, resultados que você lê de volta. Aponte um harness de avaliação para as rotas compatíveis com a OpenAI, ou use as rotas de evals diretamente.Referência da API Embeddings, rerank e moderaçãoDisponívelcruxy-embed transforma texto em vetores, cruxy-rerank ordena candidatos em relação a uma consulta, e cruxy-guard classifica texto em categorias de segurança de conteúdo.Cookbook DocumentaçãoDisponívelUm guia de início rápido, um guia para cada rota, um cookbook com retrieval, loops de ferramentas e streaming no navegador, e a referência completa da API.Leia a documentação StatusDisponívelSondas em tempo real e incidentes, em domínio próprio, para você nos checar antes de checar o seu código.Ver status

Chat

Duas rotas, um conjunto de modelos. Use a que o seu cliente já fala.

Guia de chat

POST /v1/chat/completions

Compatível com a OpenAI

Aponte qualquer cliente OpenAI ou harness de avaliação para https://api.cruxy.ai/v1 com a sua chave da Cruxy. Objetos chat.completion padrão, o SSE da OpenAI e o envelope de erro da OpenAI, com um código estável da Cruxy dentro dele.

temperature, top_p, max_tokens e reasoning_effort são respeitados
Campos que o gateway não usa são ignorados, não recusados, então um harness que os envia continua rodando
Uma execução reproduzível das suas mensagens e do modelo. Sem memória, sem cofres, sem arquivos

POST /api/v1/chat

Chat da Cruxy

Os mesmos modelos com tudo que o app da Cruxy tem: recuperação e captura de memória, cofres e regras permanentes, arquivos por id, e usage.cost em cada resposta.

memory: { recall, capture } por requisição, regras ligadas ou desligadas, um vault_id
usage.cost com o nível, o valor e a moeda em cada resposta
cruxy.request_id para localizar a chamada nos seus logs e pareá-la com 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

Defina stream como true e a resposta chega como server-sent events da OpenAI: frames chat.completion.chunk com deltas de conteúdo ou de chamada de ferramenta, depois [DONE].

Se o upstream falhar no meio do stream, o stream termina com um frame de erro em vez de [DONE], para que o seu cliente distinga um corte de um fim. A chamada de ferramentas funciona nas duas rotas: envie as funções que o modelo pode chamar, execute as que ele devolver e passe os resultados de volta.

Guia de chamada de ferramentas

A API

Cada rota, uma linha para cada. Caminhos como a referência os lista.

Referência completa da API

GRUPOROTASO QUE FAZDOCUMENTAÇÃO

Chat

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

Chat completions compatíveis com a OpenAI, o chat próprio da Cruxy com memória, cofres, regras e arquivos, e um contador de tokens.Guia de chat

Modelos

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

O catálogo de níveis, como uma lista OpenAI ou com os metadados próprios da Cruxy: janela de contexto, preços, suporte a ferramentas e padrões de raciocínio.Referência de modelos

Chamada de ferramentas

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

Envie as funções que o modelo pode chamar, execute as chamadas que ele devolver e passe os resultados de volta.Guia de chamada de ferramentas

Embeddings e rerank

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

Transforme texto em vetores com cruxy-embed e ordene documentos candidatos em relação a uma consulta com cruxy-rerank.Guia de embeddings

Moderação

POST /api/v1/moderations

Classifique texto em categorias de segurança de conteúdo com cruxy-guard e aja sobre o booleano flagged.Guia de moderação

Arquivos

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

Envie, liste, baixe e exclua arquivos, depois anexe-os a requisições de chat da Cruxy por id.Referência da API

Evals

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

Suítes de casos que você define, execuções que você inicia, e resultados que você lê de volta.Referência da API

Feedback

POST /api/v1/feedback

Informe o resultado de uma chamada anterior pelo id da requisição: aceites, rejeições, polegar para cima ou para baixo e resultados de teste.Guia de feedback

Memória, cofres e regras

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

Leia e exclua memórias, gerencie cofres e seus membros, e defina regras permanentes para uma conta ou um cofre.Referência da API

Limites e logs

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

Seus tetos de requisições por chave e por organização, e o log das suas requisições por id de requisição.Referência de erros

Chaves e organização

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

Login por dispositivo para uma chave, os membros e convites da sua organização, e espaços de trabalho.Guia de autenticação

Operar

Limites, logs e erros sobre os quais você consegue raciocinar.

Referência de erros

Limites que você pode consultar

GET /api/v1/limits devolve seus tetos de requisições de chat por chave e por organização para cada janela de 60 segundos, e o gateway envia cabeçalhos X-RateLimit. Não há limite de tokens por minuto.

Dois tipos de 429

rate_limited significa que as requisições estão chegando rápido demais; passa quando você desacelera. budget_exhausted é um teto de gastos que uma nova tentativa sozinha não resolve.

Logs por id de requisição

Cada requisição é registrada com o modelo, as contagens de tokens, o custo, o tempo e o status, e nada do prompt ou da resposta. Leia uma de volta em GET /api/v1/logs/{request_id}.

Chaves mostradas uma vez

Obtenha uma chave com o fluxo de login por dispositivo. Ela é mostrada exatamente uma vez e armazenada apenas como hash. Os segredos em repouso são criptografados campo a campo com AES-256-GCM.

Disponível

Cruxy Code

Os mesmos modelos, no seu terminal.

Planeja mudanças em várias etapas e mostra cada diff antes de você aprovar
Pergunta antes de cada edição e de cada comando, por padrão
Roda seu comando de teste, lê as falhas e continua corrigindo
cruxy rollback restaura a árvore para antes de qualquer turno
cruxy pr abre o pull request depois de uma aprovação

npm i -g @cruxy/cliExplorar o 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)

Uma sessão real, encurtada. A saída da CLI é real; as respostas do modelo são ilustrativas.

Preços da API

Por token, em USD. Sem taxa de configuração e sem mínimo.

Preços da API por completo

Fast· Mira

Chamadas curtas e de alto volume em que latência e custo importam mais.

ENTRADA: $0.20 / 1M
SAÍDA: $0.40 / 1M

Contexto: 64K
Saída máxima: 2K

Balanced· Vaani

Chamadas do dia a dia: qualidade forte com latência e custo menores.

ENTRADA: $0.65 / 1M
SAÍDA: $1.30 / 1M

Contexto: 128K
Saída máxima: 4K

Deep· Kavi

As tarefas mais difíceis: raciocínio profundo e o maior orçamento de saída.

ENTRADA: $0.76 / 1M
SAÍDA: $1.52 / 1M

Contexto: 256K
Saída máxima: 8K

USD por 1M tokens, medido por requisição. Os preços da API não incluem GST. 18% de GST é acrescentado para contas cobradas na Índia (crédito tributário disponível). Com auto, você paga a tarifa do modelo que atendeu a chamada.

Perguntas

Bom saber.

Moderação com qualquer chaveFiltre a entrada com cruxy-guard antes de chegar ao chat. A API de moderação aceita qualquer chave em qualquer plano.

Sim, para chat e para a lista de modelos. https://api.cruxy.ai/v1 serve /v1/chat/completions e /v1/models nos formatos da OpenAI, então clientes e harnesses de avaliação existentes funcionam depois que você troca a URL base e a chave. O resto da API, de arquivos a evals, é próprio da Cruxy e fica sob /api/v1.

Troque a URL base. Mantenha seu código.

Comece grátis, pague por token e leia cada limite antes de bater nele.

Comece grátis Referência da 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)

Construa o que vem a seguir.

Tudo sobre o que você pode construir. Tudo disponível, tudo documentado.

Duas rotas, um conjunto de modelos. Use a que o seu cliente já fala.

Compatível com a OpenAI

Chat da Cruxy

Cada rota, uma linha para cada. Caminhos como a referência os lista.

Limites, logs e erros sobre os quais você consegue raciocinar.

Limites que você pode consultar

Dois tipos de 429

Logs por id de requisição

Chaves mostradas uma vez

Os mesmos modelos, no seu terminal.

Por token, em USD. Sem taxa de configuração e sem mínimo.

Bom saber.

A API é compatível com a OpenAI?

Como obtenho uma chave de API?

Qual modelo devo passar?

Vocês têm um SDK?

Meus dados são usados para treinamento?

Troque a URL base. Mantenha seu código.

Construa o que vem a seguir.

Tudo sobre o que você pode construir. Tudo disponível, tudo documentado.

Duas rotas, um conjunto de modelos. Use a que o seu cliente já fala.

Compatível com a OpenAI

Chat da Cruxy

Cada rota, uma linha para cada. Caminhos como a referência os lista.

Limites, logs e erros sobre os quais você consegue raciocinar.

Limites que você pode consultar

Dois tipos de 429

Logs por id de requisição

Chaves mostradas uma vez

Os mesmos modelos, no seu terminal.

Por token, em USD. Sem taxa de configuração e sem mínimo.

Bom saber.

A API é compatível com a OpenAI?

Como obtenho uma chave de API?

Qual modelo devo passar?

Vocês têm um SDK?

Meus dados são usados para treinamento?

Troque a URL base. Mantenha seu código.