BYOK Mode

Bring Your Own Keys — use your own provider API keys and save up to 80% on every memo.

How it works

Decision Memos charges for the orchestration layer — persona-tuned prompts, synthesis, consensus scoring, and Decision Memo generation. The underlying model calls are a separate cost. When you supply your own provider keys, we pass those calls through your accounts and discount the orchestration fee accordingly.

Discount tiers

  • 1 key — 20% off per memo
  • 2 keys — 40% off per memo
  • 3 keys — 60% off per memo
  • 4 keys (all providers) — 80% off per memo

Your subscription plan includes its full memo allocation regardless of BYOK status. When using the hosted API with your keys, the orchestration fee is discounted accordingly.

Free SDK (always BYOK)

The free SDK is BYOK by default — you provide your own keys and pay only the underlying provider costs. No orchestration fee because there's no orchestration — just raw parallel queries.

import { createMultiModelQuery } from 'decisionmemos';

// Your keys, your accounts, no fee
const query = createMultiModelQuery({
  keys: {
    openai: process.env.OPENAI_API_KEY,
    anthropic: process.env.ANTHROPIC_API_KEY,
    xai: process.env.XAI_API_KEY,
    google: process.env.GOOGLE_API_KEY,
  },
});

const result = await query.ask("Should we use GraphQL?");

Hosted API (BYOK discount)

When using the hosted API, pass your provider keys in the byok field. You still need a dm_ API key for authentication and access to the orchestration layer.

POST /v1/deliberate
{
  "question": "...",
  "byok": {
    "openai": "sk-...",
    "anthropic": "sk-ant-...",
    "xai": "xai-...",
    "google": "AIza..."
  }
}

// Response header includes discount info:
// X-BYOK-Keys-Provided: 4
// X-BYOK-Discount: 80%
Warning
When using BYOK with the hosted API, your keys are used for that single request and are never stored. However, you are trusting our infrastructure with your keys for the duration of the request. If this is a concern, use the free SDK for raw queries.

Cost comparison

Hosted (our keys)

  • Pro: 30 memos included per month
  • Team: 200 memos included per month
  • Enterprise: unlimited, custom pricing

Hosted + BYOK (your keys)

  • Same included memos; orchestration fee discounted (20% per key, up to 80%)
  • Plus underlying provider costs (~$0.10–0.30 per memo) when using your keys

Free SDK (always BYOK)

  • $0 — you pay only the underlying provider costs
  • No synthesis, no personas, no Decision Memo
  • Raw parallel model responses only