BYOK · dùng khóa LLM của riêng bạn

BYOK (Mang theo khóa riêng của bạn) là khái niệm cốt lõi của Braidrun để thanh toán Mã thông báo LLM: bạn giữ Khóa API bạn nhận được từ OpenAI / Anthropic / DeepSeek / Kimi / OpenRouter, v.v. và Braidrun sẽ giúp bạn điều chỉnh nó mà không tăng giá.

Tại sao BYOK

• Thanh toán minh bạch — Mức tiêu thụ mã thông báo được ghi trực tiếp vào tài khoản LLM của chính bạn và Braidrun không chuyển nhượng hoặc tăng giá.
• Tự do người mẫu — Bạn có thể sử dụng Claude Opus, GPT-5 của tài khoản của mình và bất kỳ mô hình nhỏ định tuyến OpenRouter nào - mà không bị hạn chế bởi gói hợp nhất của nền tảng.
• Hạn ngạch và giới hạn hiện tại nằm trong tầm kiểm soát của bạn — Cần TPM cao hơn? Chỉ cần truy cập OpenAI và nâng cấp lên Cấp. Không cần phải đối phó với nền tảng.
• An toàn và có thể kiểm soát — Khóa có thể bị thu hồi trong bảng điều khiển OpenAI bất cứ lúc nào và bạn có tiếng nói cuối cùng về toàn bộ liên kết.

Nhà cung cấp được hỗ trợ

• OpenAI — GPT-4.1 / 4.1-mini / GPT-5 / o1 / o3
• Anthropic — Claude Opus 4 / Sonnet 4 / Haiku 4
• Claude Code — Anthropic API Key hoặc Claude Subscription Token (provider thông tin xác thực = claude_code_oauth)
• Codex — OpenAI API Key or Codex Subscription auth.json (Nhà cung cấp chứng nhận = mãx subscription)
• DeepSeek — DeepSeek-V3.5 / DeepSeek-Reasoning
• Kimi — Kimi K2 / 128K context
• OpenRouter — Định tuyến qua OpenRouter tới bất kỳ model nào được hỗ trợ (Mistral / Llama / Gemini, v.v.)
• LLM nội bộ (Phiên bản doanh nghiệp có thể truy cập điểm cuối vLLM / TGI / Ollama tự lưu trữ)

Bước 1: Đến Nhà cung cấp để lấy Key

Bước 2: Lưu vào Trung tâm thông tin xác thực

1. "Quản lý thông tin xác thực" ở bên trái → "Thông tin xác thực mới".
2. Gợi ý đặt tên:
   • openai_main / openai_prod / openai_test
   • anthropic_team_budget / anthropic_personal
   • deepseek_production
3. Loại: api_key; Giá trị: Dán khóa do Nhà cung cấp cung cấp cho bạn; Không gian tên: Cá nhân hoặc Nhóm (tùy thuộc vào việc bạn sử dụng một mình hay chia sẻ với nhiều người).
4. Cứu. Mã hóa và lưu trữ nền tảng.

Bước 3: Liên kết nhà cung cấp với Đại lý

agents:
  writer:
    preset: writer
    overrides:
      model: claude-opus-4-7
      provider: anthropic_team_budget    # ← 凭据中心的凭据名

Hỗ Trợ AI: Cấu hình tài khoản hiện thời

Trợ lý điều hành AI không còn phụ thuộc vào cấu hình quản trị trung tâm nữa. Tới mục Thiết lập Tài khoản I Trợ lý AI để chọn nhà cung cấp kiểu mẫu, hoặc chọn phím API / PRA trong phần Claude Code / Codex. Chỉ lưu ảnh hưởng đến tài khoản hiện thời.

Bước 4 (tùy chọn): Định cấu hình chi tiết Nhà cung cấp

Một số nhà cung cấp yêu cầu thêm cấu hình - api_base, id tổ chức, tiêu đề tùy chỉnh. Mở rộng trong "Quản lý thông tin xác thực → Cấu hình nhà cung cấp":

# 凭据中心 → Provider 配置
# 类型: OpenAI
api_base: https://api.openai.com/v1   # 或你的代理 / Azure endpoint
organization: org_xxxxx                 # 分账 organization
default_headers:
  OpenAI-Beta: assistants=v2

Chia sẻ sổ cái nhiều khóa

Tình huống: Bạn muốn giữ tài khoản theo bộ phận hoặc bạn có hai bộ khóa để phát triển/sản xuất.

1. Trong trung tâm thông tin xác thực, mỗi Khóa có một tên độc lập (openai_marketing / openai_engineering).
2. Đại lý của các workflow khác nhau bị ràng buộc với các nhà cung cấp khác nhau.
3. Về phía OpenAI, các dự án được chia thành các dự án để theo dõi mức tiêu thụ token và hóa đơn của từng dự án được tách biệt một cách tự nhiên.

Theo dõi chi phí

Ngay cả khi hóa đơn thuộc về phía Nhà cung cấp, Braidrun vẫn theo dõi mã thông báo và chi phí ước tính được chuyển đổi từ giá hiện tại của mô hình:

• Bản tóm tắt trên cùng của mỗi lần thực hiện hiển thị mã thông báo + chi phí ước tính
• Trang “Data Dashboard” tổng hợp theo ngày/tuần/tháng
• Có thể đặt cảnh báo "khi chi phí một execution vượt X"

Lưu ý rằng ước tính của Braidrun dựa trên bảng giá của nhà cung cấp dịch vụ công - nếu bạn tận dụng các khoản giảm giá (hợp đồng hàng quý của OpenAI Enterprise / DeepSeek), hóa đơn thực sẽ thấp hơn ước tính.

Giới hạn hiện tại và thử lại

Khóa của bạn có giới hạn trên TPM (Mã thông báo mỗi phút). Nền tảng này có ba lớp bảo vệ:

1. Giới hạn hiện tại của nhà cung cấp (cứng về phía Nhà cung cấp, nếu vượt quá 429)
2. Giới hạn mềm TPM nội bộ Braidrun (để tránh nổ một lần)
3. retry.backoff cấp độ bước (thử lại backoff tự động tạm thời 429)

Xoay phím

1. Tạo Key mới ở phía Nhà cung cấp (không thu hồi Key cũ).
2. Trung tâm thông tin xác thực Braidrun → Tìm thông tin xác thực tương ứng → Dán Khóa mới vào "Cập nhật giá trị".
3. Đợi 1 giờ (để quá trình chạy bằng phím cũ kết thúc).
4. Xác nhận mọi thứ đều bình thường, đến phía Nhà cung cấp để thu hồi Key cũ.

Chuyển đổi dự phòng/dự phòng

Khi Nhà cung cấp thỉnh thoảng bị giật, bạn có thể định cấu hình dự phòng trong Agent:

agents:
  writer:
    preset: writer
    overrides:
      model: claude-opus-4-7
      provider: anthropic_main
      fallback:
        model: gpt-4.1
        provider: openai_main

Dự phòng được tự động chuyển đổi khi Nhà cung cấp chính trả về giới hạn 5xx/tỷ lệ.

FAQ

Braidrun có thể thấy giá trị Khóa của tôi không?

Dịch vụ chạy nền tảng thời gian cần sử dụng chìa khóa văn bản rõ ràng để gọi Nhà cung cấp - thời điểm này được hiển thị một cách kỹ thuật. Nhưng:

• Mã hóa AES-256-GCM được sử dụng khi xóa cơ sở dữ liệu và không thể nhìn thấy văn bản thuần túy trong kết xuất DB;
• Giải mã thời gian chạy chỉ có hiệu lực trong ngữ cảnh của một bước duy nhất và không nhập nhật ký, ghi ảnh chụp nhanh hoặc chuyển sang các bước khác;
• Phiên bản doanh nghiệp hỗ trợ tích hợp HSM/KMS, việc giải mã khóa được thực hiện trong KMS được quản lý.

Tôi có thể kết hợp tín dụng nền tảng + BYOK không?

Đúng. Nếu Đại lý không được trang bị nhà cung cấp thì sẽ sử dụng khóa thống nhất của nền tảng (lấy hạn ngạch nền tảng); nếu nó được trang bị bởi nhà cung cấp, nó sẽ sử dụng Key của bạn. Các bước khác nhau có thể được trộn lẫn trong cùng một quy trình làm việc.

Bước tiếp theo

• Nhận diện — Trung tâm chứng chỉ để biết thêm chi tiết
• Hướng dẫn cấu hình Agent — Trường ghi đè nào được sử dụng với nhà cung cấp