Làm sao để lấy khóa API?

Đăng ký Cruxy và tạo khóa bằng luồng đăng nhập thiết bị được mô tả trong hướng dẫn bắt đầu nhanh: yêu cầu mã thiết bị, phê duyệt trong trình duyệt và poll để nhận khóa. Khóa API đến từ cùng tài khoản với ứng dụng, và API được tính theo token, tách biệt với gói của bạn.

Tôi nên truyền mô hình nào?

Truyền auto trừ khi bạn có lý do để không làm vậy. Mira là kích cỡ Fast cho lời gọi ngắn, khối lượng lớn, Vaani là mặc định cân bằng, và Kavi là kích cỡ Deep cho những tác vụ khó nhất. Mô hình đứng sau một kích cỡ có thể thay đổi; id kích cỡ là cam kết.

Bạn có SDK không?

Bất kỳ client OpenAI nào cũng dùng được cho chat completions và models, bằng ngôn ngữ bạn đang dùng. Với các route riêng của Cruxy, tài liệu hiển thị yêu cầu bằng curl và TypeScript với fetch.

Dữ liệu của tôi có được dùng để huấn luyện không?

Prompt và kết quả đầu ra của bạn không được dùng để huấn luyện mô hình AI nếu không có sự đồng ý rõ ràng, riêng biệt của bạn. Log yêu cầu giữ mô hình, số token, chi phí và thời gian, và không giữ nội dung nào. Chính sách quyền riêng tư có đầy đủ chi tiết.

Nhà phát triển

Xây dựng điều tiếp theo.

Một URL cơ sở, một khóa và ba kích cỡ mô hình phía sau. Một API tương thích OpenAI cho chat, các route riêng của Cruxy khi bạn muốn bộ nhớ, kho, tệp và evals, và một CLI làm việc trong repo của bạn.

Bắt đầu miễn phí Đọc hướng dẫn bắt đầu nhanh

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

Yêu cầu là thật. Phản hồi chỉ mang tính minh họa và được cắt gọn về đúng hình dạng của nó.

URL cơ sở: api.cruxy.ai/v1
Mô hình: kavi · vaani · mira · auto
Streaming: SSE của OpenAI, kết thúc bằng [DONE]
Lỗi: Một mã ổn định cho mỗi lỗi

Nền tảng

Mọi thứ bạn có thể xây dựng trên đó. Tất cả đang hoạt động, tất cả có tài liệu.

Chat APIĐang hoạt độngChat completions tương thích OpenAI trên ba kích cỡ mô hình. Streaming, gọi công cụ và reasoning_effort bạn đặt theo từng yêu cầu.Hướng dẫn Chat Cruxy CodeĐang hoạt độngMột tác nhân lập trình cho terminal của bạn. Đọc mã nguồn của bạn, sửa tệp với diff trước mỗi lần phê duyệt, chạy kiểm thử của bạn và mở pull request.Khám phá Cruxy Code Evals APIĐang hoạt độngCác bộ trường hợp bạn định nghĩa, các lần chạy bạn khởi động, kết quả bạn đọc lại. Trỏ một công cụ đánh giá vào các route tương thích OpenAI, hoặc dùng trực tiếp các route evals.Tài liệu tham khảo API Embedding, rerank và kiểm duyệtĐang hoạt độngcruxy-embed biến văn bản thành vector, cruxy-rerank sắp xếp các ứng viên theo một truy vấn, và cruxy-guard phân loại văn bản theo các danh mục an toàn nội dung.Cookbook Tài liệuĐang hoạt độngMột hướng dẫn bắt đầu nhanh, một hướng dẫn cho mỗi route, một cookbook với truy xuất, vòng lặp công cụ và streaming trong trình duyệt, và tài liệu tham khảo API đầy đủ.Đọc tài liệu Trạng tháiĐang hoạt độngKiểm tra trực tiếp và sự cố, trên tên miền riêng, để bạn có thể kiểm tra chúng tôi trước khi kiểm tra mã của bạn.Xem trạng thái

Chat

Hai route, một bộ mô hình. Dùng route mà client của bạn vốn đã hiểu.

Hướng dẫn Chat

POST /v1/chat/completions

Tương thích OpenAI

Trỏ bất kỳ client OpenAI hay công cụ đánh giá nào đến https://api.cruxy.ai/v1 với khóa Cruxy của bạn. Đối tượng chat.completion chuẩn, SSE của OpenAI và định dạng lỗi của OpenAI, với một mã Cruxy ổn định bên trong.

temperature, top_p, max_tokens và reasoning_effort đều được áp dụng
Các trường gateway không dùng sẽ bị bỏ qua, không bị từ chối, nên một công cụ đánh giá gửi chúng vẫn chạy được
Một lần chạy tái lập được của các tin nhắn và mô hình của bạn. Không bộ nhớ, không kho, không tệp

POST /api/v1/chat

Chat của Cruxy

Cùng các mô hình với mọi thứ ứng dụng Cruxy có: truy hồi và ghi lại ký ức, kho và quy tắc thường trực, tệp theo id, và usage.cost trên mỗi câu trả lời.

memory: { recall, capture } theo từng yêu cầu, quy tắc bật hoặc tắt, một vault_id
usage.cost với bậc, số tiền và loại tiền trong mỗi phản hồi
cruxy.request_id để tra lời gọi trong log của bạn và ghép nó với 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

Đặt stream thành true và câu trả lời đến dưới dạng server-sent events của OpenAI: các khung chat.completion.chunk với delta nội dung hoặc delta gọi công cụ, rồi [DONE].

Nếu upstream thất bại giữa luồng, luồng kết thúc bằng một khung lỗi thay vì [DONE], nên client của bạn phân biệt được bị cắt ngang với kết thúc bình thường. Gọi công cụ hoạt động trên cả hai route: gửi các hàm mô hình có thể gọi, chạy những hàm nó trả về và đưa kết quả trở lại.

Hướng dẫn gọi công cụ

API

Mọi route, mỗi route một dòng. Đường dẫn như tài liệu tham khảo liệt kê.

Tài liệu tham khảo API đầy đủ

NHÓMROUTECHỨC NĂNGTÀI LIỆU

Chat

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

Chat completions tương thích OpenAI, chat riêng của Cruxy với bộ nhớ, kho, quy tắc và tệp, và một bộ đếm token.Hướng dẫn Chat

Mô hình

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

Danh mục các bậc, dưới dạng danh sách OpenAI hoặc với siêu dữ liệu riêng của Cruxy: cửa sổ ngữ cảnh, giá, hỗ trợ công cụ và mặc định suy luận.Tài liệu tham khảo mô hình

Gọi công cụ

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

Gửi các hàm mô hình có thể gọi, chạy các lời gọi nó trả về và đưa kết quả trở lại.Hướng dẫn gọi công cụ

Embedding và rerank

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

Biến văn bản thành vector với cruxy-embed và sắp xếp các tài liệu ứng viên theo một truy vấn với cruxy-rerank.Hướng dẫn embedding

Kiểm duyệt

POST /api/v1/moderations

Phân loại văn bản theo các danh mục an toàn nội dung với cruxy-guard và hành động dựa trên boolean flagged.Hướng dẫn kiểm duyệt

Tệp

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

Tải lên, liệt kê, tải xuống và xóa tệp, rồi đính kèm chúng vào các yêu cầu chat của Cruxy theo id.Tài liệu tham khảo API

Evals

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

Các bộ trường hợp bạn định nghĩa, các lần chạy bạn khởi động, và kết quả bạn đọc lại.Tài liệu tham khảo API

Feedback

POST /api/v1/feedback

Báo kết quả của một lời gọi trước đó theo request id của nó: chấp nhận, từ chối, thích/không thích và kết quả kiểm thử.Hướng dẫn Feedback

Bộ nhớ, kho và quy tắc

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

Đọc và xóa ký ức, quản lý kho và thành viên của kho, và đặt quy tắc thường trực cho một tài khoản hoặc một kho.Tài liệu tham khảo API

Giới hạn và log

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

Mức trần yêu cầu theo khóa và theo tổ chức của bạn, và log các yêu cầu của bạn theo request id.Tài liệu tham khảo lỗi

Khóa và tổ chức

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

Đăng nhập thiết bị để lấy khóa, thành viên và lời mời của tổ chức bạn, và các không gian làm việc.Hướng dẫn xác thực

Vận hành

Giới hạn, log và lỗi bạn có thể lý giải.

Tài liệu tham khảo lỗi

Giới hạn bạn có thể đọc

GET /api/v1/limits trả về mức trần yêu cầu chat theo khóa và theo tổ chức của bạn cho mỗi cửa sổ 60 giây, và gateway gửi các header X-RateLimit. Không có giới hạn token mỗi phút.

Hai loại 429

rate_limited nghĩa là yêu cầu đến quá nhanh; nó hết khi bạn chậm lại. budget_exhausted là mức trần chi tiêu mà chỉ thử lại sẽ không giải quyết được.

Log theo request id

Mọi yêu cầu được ghi log với mô hình, số token, chi phí, thời gian và trạng thái, và không có prompt hay câu trả lời. Đọc lại một yêu cầu tại GET /api/v1/logs/{request_id}.

Khóa chỉ hiển thị một lần

Lấy khóa bằng luồng đăng nhập thiết bị. Nó được hiển thị đúng một lần và chỉ được lưu dưới dạng hash. Thông tin bí mật khi lưu trữ được mã hóa theo từng trường bằng AES-256-GCM.

Đang hoạt động

Cruxy Code

Cùng các mô hình, trong terminal của bạn.

Lập kế hoạch các thay đổi nhiều bước và hiển thị mọi diff trước khi bạn phê duyệt
Hỏi trước mỗi lần sửa và mỗi lệnh, theo mặc định
Chạy lệnh kiểm thử của bạn, đọc các lỗi và tiếp tục sửa
cruxy rollback khôi phục cây tệp về trước bất kỳ lượt nào
cruxy pr mở pull request sau một lần phê duyệt

npm i -g @cruxy/cliKhám phá 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)

Một phiên thật, được cắt ngắn. Đầu ra CLI là thật; câu trả lời của mô hình chỉ mang tính minh họa.

Bảng giá API

Theo token, bằng USD. Không phí thiết lập và không mức tối thiểu.

Bảng giá API đầy đủ

Fast· Mira

Lời gọi ngắn, khối lượng lớn, nơi độ trễ và chi phí quan trọng nhất.

ĐẦU VÀO: $0.20 / 1M
ĐẦU RA: $0.40 / 1M

Ngữ cảnh: 64K
Đầu ra tối đa: 2K

Balanced· Vaani

Lời gọi hằng ngày: chất lượng tốt với độ trễ và chi phí thấp hơn.

ĐẦU VÀO: $0.65 / 1M
ĐẦU RA: $1.30 / 1M

Ngữ cảnh: 128K
Đầu ra tối đa: 4K

Deep· Kavi

Những tác vụ khó nhất: suy luận sâu và ngân sách đầu ra lớn nhất.

ĐẦU VÀO: $0.76 / 1M
ĐẦU RA: $1.52 / 1M

Ngữ cảnh: 256K
Đầu ra tối đa: 8K

USD cho mỗi 1M token, đo theo từng yêu cầu. Giá API chưa bao gồm GST. 18% GST được cộng thêm cho các tài khoản thanh toán tại Ấn Độ (có thể khấu trừ thuế đầu vào). Với auto, bạn trả theo giá của mô hình đã phục vụ lời gọi.

Câu hỏi

Những điều nên biết.

Kiểm duyệt với bất kỳ khóa nàoSàng lọc đầu vào bằng cruxy-guard trước khi nó đến với chat. API kiểm duyệt nhận bất kỳ khóa nào trên bất kỳ gói nào.

Có, cho chat và danh sách mô hình. https://api.cruxy.ai/v1 phục vụ /v1/chat/completions và /v1/models theo hình dạng của OpenAI, nên các client và công cụ đánh giá hiện có hoạt động ngay khi bạn đổi URL cơ sở và khóa. Phần còn lại của API, từ tệp đến evals, là của riêng Cruxy và nằm dưới /api/v1.

Đổi URL cơ sở. Giữ nguyên mã của bạn.

Bắt đầu miễn phí, trả theo token, và đọc mọi giới hạn trước khi bạn chạm đến.

Bắt đầu miễn phí Tài liệu tham khảo API

Xây dựng điều tiếp theo.

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)

Xây dựng điều tiếp theo.

Mọi thứ bạn có thể xây dựng trên đó. Tất cả đang hoạt động, tất cả có tài liệu.

Hai route, một bộ mô hình. Dùng route mà client của bạn vốn đã hiểu.

Tương thích OpenAI

Chat của Cruxy

Mọi route, mỗi route một dòng. Đường dẫn như tài liệu tham khảo liệt kê.

Giới hạn, log và lỗi bạn có thể lý giải.

Giới hạn bạn có thể đọc

Hai loại 429

Log theo request id

Khóa chỉ hiển thị một lần

Cùng các mô hình, trong terminal của bạn.

Theo token, bằng USD. Không phí thiết lập và không mức tối thiểu.

Những điều nên biết.

API có tương thích OpenAI không?

Làm sao để lấy khóa API?

Tôi nên truyền mô hình nào?

Bạn có SDK không?

Dữ liệu của tôi có được dùng để huấn luyện không?

Đổi URL cơ sở. Giữ nguyên mã của bạn.

Xây dựng điều tiếp theo.

Mọi thứ bạn có thể xây dựng trên đó. Tất cả đang hoạt động, tất cả có tài liệu.

Hai route, một bộ mô hình. Dùng route mà client của bạn vốn đã hiểu.

Tương thích OpenAI

Chat của Cruxy

Mọi route, mỗi route một dòng. Đường dẫn như tài liệu tham khảo liệt kê.

Giới hạn, log và lỗi bạn có thể lý giải.

Giới hạn bạn có thể đọc

Hai loại 429

Log theo request id

Khóa chỉ hiển thị một lần

Cùng các mô hình, trong terminal của bạn.

Theo token, bằng USD. Không phí thiết lập và không mức tối thiểu.

Những điều nên biết.

API có tương thích OpenAI không?

Làm sao để lấy khóa API?

Tôi nên truyền mô hình nào?

Bạn có SDK không?

Dữ liệu của tôi có được dùng để huấn luyện không?

Đổi URL cơ sở. Giữ nguyên mã của bạn.