BYOK · usa tu propia LLM Key

BYOK (Traiga su propia clave) es el concepto central de Braidrun para la facturación de tokens LLM: usted conserva la clave API que obtiene de OpenAI/Anthropic/DeepSeek/Kimi/OpenRouter, etc., y Braidrun le ayudará a ajustarla sin aumentar el precio.

¿Por qué BYOK?

• Facturación transparente — El consumo de tokens se registra directamente en su propia cuenta LLM y Braidrun no transfiere ni aumenta los precios.
• Libertad modelo — Puede utilizar Claude Opus, GPT-5 y cualquier modelo pequeño de enrutamiento OpenRouter de su propia cuenta, sin estar restringido por el paquete unificado de la plataforma.
• La cuota y el límite actual están bajo tu control — ¿Necesita un TPM más alto? Simplemente vaya a OpenAI y actualice al nivel. No es necesario lidiar con la plataforma.
• Seguro y controlable — La clave se puede revocar en la consola de OpenAI en cualquier momento y usted tiene la última palabra sobre todo el enlace.

Proveedores compatibles

• OpenAI — GPT-4.1 / 4.1-mini / GPT-5 / o1 / o3
• Anthropic — Claude Opus 4 / Sonnet 4 / Haiku 4
• Claude Code — Clave API antrópica o token de suscripción Claude (credencial provider=claude_code_oauth)
• Codex — Clave API de OpenAI o suscripción al Codex auth.json (Credenciales provider=codex_subscription)
• DeepSeek — DeepSeek-V3.5 / DeepSeek-Reasoning
• Kimi — Kimi K2 / 128K context
• OpenRouter — Enrutamiento vía OpenRouter a cualquiera de sus modelos soportados (Mistral / Llama / Gemini etc.)
• LLM interno (la versión Enterprise puede acceder al punto final vLLM/TGI/Ollama autohospedado)

Paso 1: vaya al proveedor para obtener la clave

Paso 2: Guardar en el Centro de credenciales

1. "Gestión de credenciales" a la izquierda → "Nueva credencial".
2. Sugerencias de nombres:
   • openai_main / openai_prod / openai_test
   • anthropic_team_budget / anthropic_personal
   • deepseek_production
3. Tipo: api_key; Valor: Pegue la clave que le proporcionó el Proveedor; Espacio de nombres: Individual o Equipo (dependiendo de si lo usas solo o lo compartes con varias personas).
4. Guardar. Cifrado y almacenamiento de plataforma.

Paso 3: vincular el proveedor al agente

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

Asistente AI: configurar cuenta actual

El asistente de IA interno ya no depende de una configuración centralizada del administrador. Ve a Configuración de la cuenta → Asistente de IA para elegir el provider del modelo, o elige modo API key / cuota de suscripción en Claude Code / Codex. Guardar solo afecta a la cuenta actual.

Paso 4 (opcional): configurar los detalles del proveedor

Algunos proveedores requieren más configuración: api_base, identificación de la organización, encabezados personalizados. Ampliar en "Gestión de credenciales → Configuración de proveedor":

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

Compartir libro mayor de claves múltiples

Escenario: desea llevar cuentas por departamento o tiene dos conjuntos de claves para desarrollo/producción.

1. En el centro de credenciales, cada Clave tiene un nombre independiente (openai_marketing/openai_engineering).
2. Los agentes de diferentes flujos de trabajo están vinculados a diferentes proveedores.
3. En el lado de OpenAI, los proyectos se dividen en proyectos para rastrear el consumo de tokens y las facturas de cada proyecto se separan naturalmente.

Seguimiento de costos

Incluso si la factura es del lado del Proveedor, Braidrun aún rastrea el token y el costo estimado convertido del precio actual del modelo:

• El resumen superior de cada ejecución muestra tokens + costo estimado.
• La página "Panel de datos" se agrega por día/semana/mes
• Puede configurar "Alarma cuando el costo de ejecución única excede X"

Tenga en cuenta que las estimaciones de Braidrun se basan en la lista de precios de proveedores públicos: si aprovecha los descuentos (contrato trimestral OpenAI Enterprise/DeepSeek), la factura real será inferior a la estimación.

Limitación de corriente y reintentos

Su clave tiene un límite superior de TPM (Tokens por minuto). La plataforma tiene tres capas de protección:

1. Límite actual del proveedor (dificultad del lado del proveedor, si excede 429)
2. Límite suave interno de TPM de Braidrun (para evitar una explosión única)
3. reintento.backoff a nivel de paso (reintento de retroceso automático transitorio 429)

Rotación de claves

1. Cree una nueva clave en el lado del proveedor (no revoque la anterior).
2. Centro de credenciales de Braidrun → Busque la credencial correspondiente → Pegue la nueva clave en "Actualizar valor".
3. Espere 1 hora (para dejar que finalice la ejecución con la clave anterior).
4. Confirme que todo es normal, vaya al lado del Proveedor para revocar la Clave anterior.

Conmutación por error/retroceso

Cuando el Proveedor tiembla ocasionalmente, puede configurar el respaldo en el Agente:

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

El respaldo se cambia automáticamente cuando el proveedor principal devuelve 5xx/límite de tasa.

FAQ

¿Puede Braidrun ver mi valor clave?

El servicio de la plataforma de ejecución necesita utilizar la clave de texto claro para llamar al proveedor; este momento es técnicamente visible. Pero:

• Se utiliza el cifrado AES-256-GCM al descartar la base de datos y el texto sin formato no se puede ver en el volcado de la base de datos;
• El descifrado en tiempo de ejecución solo tiene efecto en el contexto de un solo paso y no ingresa registros, no escribe instantáneas ni fluye hacia otros pasos;
• La versión empresarial admite la integración HSM/KMS, el descifrado de claves se realiza en el KMS administrado.

¿Puedo combinar crédito de plataforma + BYOK?

Sí. Si el Agente no está equipado con un proveedor, utilizará la clave unificada de la plataforma (tomando la cuota de la plataforma); si está equipado con un proveedor, utilizará su clave. Se pueden mezclar diferentes pasos en el mismo flujo de trabajo.

Siguiente paso

• Credenciales — Centro de credenciales para más detalles
• Explicación detallada de la configuración del Agente — Qué campos de anulación se utilizan con el proveedor