BYOK · utilisez votre propre LLM Key

BYOK (Bring Your Own Key) est le concept de base de Braidrun pour la facturation des jetons LLM : vous conservez la clé API que vous obtenez d'OpenAI / Anthropic / DeepSeek / Kimi / OpenRouter, etc., et Braidrun vous aidera à l'ajuster sans augmenter le prix.

Pourquoi BYOK

• Facturation transparente — La consommation de jetons est directement enregistrée dans votre propre compte LLM, et Braidrun ne transfère ni n'augmente les prix.
• Liberté de modèle — Vous pouvez utiliser Claude Opus, GPT-5 et n'importe quel petit modèle de routage OpenRouter de votre propre compte - sans être limité par le package unifié de la plateforme.
• Le quota et la limite actuelle sont sous votre contrôle — Besoin d'un TPM plus élevé ? Accédez simplement à OpenAI et passez au niveau. Pas besoin de s'occuper de la plateforme.
• Sûr et contrôlable — La clé peut être révoquée dans la console OpenAI à tout moment et vous avez le dernier mot sur l'ensemble du lien.

Fournisseurs pris en charge

• OpenAI — GPT-4.1 / 4.1-mini / GPT-5 / o1 / o3
• Anthropic — Claude Opus 4 / Sonnet 4 / Haiku 4
• Claude Code — Clé API Anthropic ou jeton d'abonnement Claude (identifiant provider=claude_code_oauth)
• Codex — Clé API OpenAI ou abonnement Codex auth.json (identifiants provider=codex_subscription)
• DeepSeek — DeepSeek-V3.5 / DeepSeek-Reasoning
• Kimi — Kimi K2 / 128K context
• OpenRouter — Routage via OpenRouter vers l'un de ses modèles pris en charge (Mistral / Llama / Gemini etc.)
• LLM interne (la version Entreprise peut accéder au point de terminaison vLLM/TGI/Ollama auto-hébergé)

Étape 1 : Accédez au fournisseur pour obtenir la clé

Étape 2 : Enregistrer dans le centre d'informations d'identification

1. « Gestion des informations d'identification » à gauche → « Nouvelles informations d'identification ».
2. Suggestions de noms :
   • openai_main / openai_prod / openai_test
   • anthropic_team_budget / anthropic_personal
   • deepseek_production
3. Tapez : api_key ; Valeur : Collez la clé qui vous a été fournie par le fournisseur ; Espace de noms : Individuel ou Équipe (selon que vous l'utilisez seul ou que vous le partagez avec plusieurs personnes).
4. Enregistrez. Cryptage et stockage de la plateforme.

Step 3: Bind provider to Agent

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

AI assistant : configurer le compte courant

L’assistant IA intégré ne dépend plus d’une configuration centralisée par l’administrateur. Allez dans Paramètres du compte → Assistant IA pour choisir le provider du modèle, ou choisissez le mode clé API / quota d’abonnement dans Claude Code / Codex. L’enregistrement n’affecte que le compte actuel.

Étape 4 (facultative) : configurer les détails du fournisseur

Certains fournisseurs nécessitent plus de configuration : api_base, identifiant d'organisation, en-têtes personnalisés. Développez dans « Gestion des informations d'identification → Configuration du fournisseur » :

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

Partage du grand livre multi-clés

Scénario : Vous souhaitez tenir une comptabilité par département, ou vous disposez de deux jeux de clés pour le développement/production.

1. Dans le centre d'informations d'identification, chaque clé a un nom indépendant (openai_marketing / openai_engineering).
2. Les agents de différents workflows sont liés à différents fournisseurs.
3. Du côté d'OpenAI, les projets sont divisés en projets pour suivre la consommation des tokens, et les factures de chaque projet sont naturellement séparées.

Suivi des coûts

Même si la facture est du côté du fournisseur, Braidrun suit toujours le jeton et le coût estimé converti à partir du prix actuel du modèle :

• Le résumé supérieur de chaque exécution montre les jetons + le coût estimé
• La page "Tableau de bord des données" regroupe par jour/semaine/mois
• Vous pouvez définir "Alarme lorsque le coût d'exécution unique dépasse X"

Notez que les estimations de Braidrun sont basées sur la grille tarifaire du fournisseur public - si vous profitez de réductions (contrat trimestriel OpenAI Enterprise / DeepSeek), la facture réelle sera inférieure à l'estimation.

Limitation du courant et nouvelle tentative

Votre clé a une limite supérieure de TPM (Tokens Per Minute). La plateforme dispose de trois niveaux de protection :

1. Limite actuelle du fournisseur (dure du côté du fournisseur, si elle dépasse 429)
2. Limite logicielle TPM interne de Braidrun (pour éviter une explosion unique)
3. retry.backoff au niveau de l'étape (nouvelle tentative d'interruption automatique transitoire 429)

Rotation des clés

1. Créez une nouvelle clé côté fournisseur (ne révoquez pas l’ancienne).
2. Braidrun Credential Center → Recherchez les informations d'identification correspondantes → Collez la nouvelle clé dans « Mettre à jour la valeur ».
3. Attendez 1 heure (pour laisser l'exécution en cours avec l'ancienne clé se terminer).
4. Confirmez que tout est normal, allez du côté du fournisseur pour révoquer l'ancienne clé.

Basculement/Repli

Lorsque le fournisseur tremble occasionnellement, vous pouvez configurer une solution de secours dans l'agent :

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

Le repli est automatiquement commuté lorsque le fournisseur principal renvoie 5xx/limite de débit.

FAQ

Braidrun peut-il voir la valeur de ma clé ?

Le service de la plateforme d'exécution doit utiliser la clé en texte clair pour appeler le fournisseur - ce moment est techniquement visible. Mais :

• Le cryptage AES-256-GCM est utilisé lors de la suppression de la base de données et le texte brut ne peut pas être vu dans le dump de la base de données ;
• Le déchiffrement à l'exécution ne prend effet que dans le contexte d'une seule étape et n'entre pas dans les journaux, n'écrit pas d'instantanés et ne se propage pas vers d'autres étapes ;
• La version Entreprise prend en charge l'intégration HSM/KMS, le déchiffrement des clés est effectué dans le KMS géré.

Puis-je mélanger crédit de plateforme + BYOK ?

Oui. Si l'Agent n'est pas équipé d'un prestataire, il utilisera la clé unifiée de la plateforme (en prenant le quota de la plateforme) ; s'il est équipé d'un prestataire, il utilisera votre Clé. Différentes étapes peuvent être mélangées dans un même workflow.

Étape suivante

• Identifiants — Centre d'informations d'identification pour plus de détails
• Explication détaillée de la configuration de l'agent — Quels champs de remplacement sont utilisés avec le fournisseur