BYOK · 自分の LLM Key を利用

BYOK (Bring Your Own Key) は、Braidrun の LLM トークン課金の中核概念です。OpenAI / Anthropic / DeepSeek / Kim / OpenRouter などから取得した API キーを保持すると、Braidrun が価格を上げずに調整するのに役立ちます。

なぜBYOKなのか

• 透明性のある請求 — トークンの消費はお客様自身の LLM アカウントに直接記録され、Braidrun が価格を移転したり値上げしたりすることはありません。
• モデルの自由 — プラットフォームの統合パッケージによる制限を受けることなく、自分のアカウントの Claude Opus、GPT-5、および任意の OpenRouter ルーティング小規模モデルを使用できます。
• クォータと現在の制限は制御可能です — より高い TPM が必要ですか? OpenAI にアクセスして Tier にアップグレードするだけです。プラットフォームを扱う必要はありません。
• 安全で制御可能 — キーは OpenAI コンソールでいつでも取り消すことができ、リンク全体に対する最終決定権を持っています。

サポートされているプロバイダー

• OpenAI — GPT-4.1 / 4.1-mini / GPT-5 / o1 / o3
• Anthropic — Claude Opus 4 / Sonnet 4 / Haiku 4
• Claude Code — Anthropic API キーまたはクロード サブスクリプション トークン (資格情報 provider=claude_code_oauth)
• Codex — OpenAI API キーまたは Codex サブスクリプション auth.json (認証情報 provider=codex_subscription)
• DeepSeek — DeepSeek-V3.5 / DeepSeek-Reasoning
• Kimi — Kimi K2 / 128K context
• OpenRouter — OpenRouter 経由でサポートされているモデル (Mistral / Llama / Gemini など) へのルーティング
• 内部 LLM (エンタープライズ バージョンはセルフホスト型 vLLM / TGI / Ollama エンドポイントにアクセス可能)

ステップ 1: プロバイダーに移動してキーを取得します

ステップ 2: 資格情報センターに保存する

1. 左側の「認証情報管理」→「新しい認証情報」。
2. ネーミングの提案:
   • openai_main / openai_prod / openai_test
   • anthropic_team_budget / anthropic_personal
   • deepseek_production
3. タイプ: api_key;値: プロバイダーから提供されたキーを貼り付けます。名前空間: 個人またはチーム (単独で使用しているか、複数の人と共有しているかによって異なります)。
4. 保存します。プラットフォームの暗号化とストレージ。

ステップ 3: プロバイダーをエージェントにバインドする

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

AI アシスタント: 現在のアカウントを構成する

アプリ内 AI アシスタントは管理者の一元設定に依存しなくなりました。「アカウント設定 → AI アシスタント」でモデル provider を選択するか、Claude Code / Codex セクションで API Key / サブスクリプション枠モードを選択します。保存しても現在のアカウントにのみ影響します。

ステップ 4 (オプション): プロバイダーの詳細を構成する

一部のプロバイダーでは、api_base、組織 ID、カスタム ヘッダーなどの追加の構成が必要です。 「資格情報管理 → プロバイダー構成」を展開します。

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

マルチキー台帳共有

シナリオ: 部門ごとにアカウントを保持したい場合、または開発/運用用に 2 セットのキーがある場合。

1. 資格情報センターでは、各キーに独立した名前 (openai_marketing / openai_engineering) が付けられます。
2. 異なるワークフローのエージェントは異なるプロバイダーにバインドされます。
3. OpenAI 側では、トークンの消費を追跡するためにプロジェクトが分割され、各プロジェクトの請求書も自然に分離されます。

コスト追跡

請求がプロバイダー側にある場合でも、Braidrun はトークンと、モデルの現在の価格から換算された推定コストを追跡します。

• 各実行の上部のサマリーには、トークン + 推定コストが表示されます
• 「データダッシュボード」ページでは、日/週/月ごとに集計されます。
• 「1回の実行コストがXを超えたときにアラームを鳴らす」を設定できます

Braidrun の見積もりは公開プロバイダーの価格表に基づいていることに注意してください。割引 (OpenAI Enterprise / DeepSeek の四半期契約) を利用すると、実際の請求額は見積もりよりも低くなります。

電流制限とリトライ

キーには TPM (1 分あたりのトークン数) の上限があります。プラットフォームには 3 つの保護層があります。

1. プロバイダーの電流制限 (429 を超える場合はプロバイダー側で厳しくなります)
2. Braidrun の内部 TPM ソフト リミット (1 回限りの爆発を避けるため)
3. ステップレベルの retry.backoff (一時的な 429 自動バックオフ再試行)

キーのローテーション

1. プロバイダー側で新しいキーを作成します (古いキーを取り消さないでください)。
2. Braidrun Credential Center → 対応する認証情報を検索 → 「値の更新」に新しいキーを貼り付けます。
3. 1 時間待ちます (古いキーで実行中の実行が終了するまで)。
4. すべてが正常であることを確認し、プロバイダー側に移動して古いキーを取り消します。

フェイルオーバー/フォールバック

When the Provider occasionally jitters, you can configure fallback in the Agent:

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

メインプロバイダーが 5xx / レート制限を返すと、フォールバックが自動的に切り替わります。

FAQ

Braidrun は私の Key 値を確認できますか?

ランタイム プラットフォーム サービスは、プロバイダーを呼び出すためにクリア テキスト キーを使用する必要があります。この瞬間は技術的に明らかです。しかし:

• データベースの削除時には AES-256-GCM 暗号化が使用され、DB ダンプではプレーン テキストを確認できません。
• ランタイム復号化は単一ステップのコンテキストでのみ有効であり、ログの入力、スナップショットの書き込み、または他のステップへの流出は行いません。
• エンタープライズ バージョンは HSM / KMS 統合をサポートしており、キーの復号化はマネージド KMS で行われます。

プラットフォーム クレジットと BYOK を組み合わせることはできますか?

はい。エージェントにプロバイダーが装備されていない場合、エージェントはプラットフォームの統合キーを使用します (プラットフォーム クォータを取得します)。プロバイダーが装備されている場合は、キーが使用されます。同じワークフロー内に異なるステップを混在させることができます。

次のステップ

• 認証情報 — 詳細については資格情報センター
• エージェント構成の詳細説明 — プロバイダーで使用されるオーバーライド フィールド