{
    "$schema": "./provider-catalog.schema.json",
    "id": "bee-heossi",
    "displayName": "Bee by HEOSSI",
    "aliases": [],
    "tier": 2,
    "wire": {
        "baseURL": "https://api.bee.heossi.com/bee"
    },
    "models": {
        "default": "bee-cell",
        "fallbacks": ["bee-brood", "bee-comb", "bee-buzz", "bee-hive", "bee-swarm"],
        "defaultContextWindow": 128000,
        "defaultMaxOutputTokens": 4096,
        "catalog": {
            "bee-cell": {
                "contextWindow": 128000,
                "pricingPerMTok": {
                    "input": 0.3,
                    "output": 1.2
                },
                "vision": false,
                "status": "production",
                "description": "Bee Cell 1.0 — HEOSSI's free, entry-tier model and the one used in every SDK/curl example on https://bee.heossi.com/docs/sdks (retrieved 2026-09-28), so it is the most defensible default without a live probe. Free hosted access, no card required: 'Full Bee experience with dynamic fair use — free to start' (https://bee.heossi.com/pricing, retrieved 2026-09-28). Context 128K and $0.30 / $1.20 per 1M input/output tokens per the same pricing page; no per-request output-token ceiling is documented. The 2026-07-11 changelog states tool/function calling and JSON-mode structured output are live on Comb, Buzz and Hive only — Cell is not named, so tools/structured output are not assumed here. No image input is documented for this tier. Roster-verified only (unauthenticated GET /bee/models, 2026-09-28); no live capability probe was run (credential-free onboarding)."
            },
            "bee-cell-20260710-r1": {
                "vision": false,
                "status": "production",
                "description": "Immutable pinned snapshot behind the bee-cell alias (current_snapshot field on GET /bee/models, 2026-09-28). Same tier as bee-cell; see that entry for pricing/context. Roster-listed only."
            },
            "bee-brood": {
                "contextWindow": 256000,
                "pricingPerMTok": {
                    "input": 0.6,
                    "output": 2.4
                },
                "vision": false,
                "status": "production",
                "description": "Bee Brood 1.0 — second tier, $30/mo on the Workspace track or $0.60 / $2.40 per 1M input/output tokens on the API track (https://bee.heossi.com/pricing, retrieved 2026-09-28). Context 256K per the same page. Not named among Comb/Buzz/Hive in the 2026-07-11 changelog's tool-calling/JSON-mode announcement, so those capabilities are not assumed for this tier. Fallback; roster-verified only, not capability-probed."
            },
            "bee-brood-20260710-r1": {
                "vision": false,
                "status": "production",
                "description": "Immutable pinned snapshot behind the bee-brood alias (GET /bee/models, 2026-09-28). Roster-listed only."
            },
            "bee-comb": {
                "contextWindow": 256000,
                "pricingPerMTok": {
                    "input": 1.25,
                    "output": 5.0
                },
                "vision": false,
                "status": "production",
                "description": "Bee Comb 2.0 (current snapshot bee-comb-20260827-r1 per GET /bee/models, 2026-09-28) — base context 256K, $1.25 / $5.00 per 1M input/output tokens (https://bee.heossi.com/pricing, retrieved 2026-09-28). The 2026-07-11 changelog also describes a separately routed long-context mode serving up to 1,010,000 tokens for Comb and Buzz — that is a distinct routed path, not modeled as this catalog entry's context window. The same changelog entry states tool/function calling and JSON-mode structured output are live on Comb (along with Buzz and Hive) — see capabilities.tools ('model-dependent') and the provider-level structuredOutput note. Fallback; roster-verified only, not capability-probed."
            },
            "bee-comb-20260710-r1": {
                "vision": false,
                "status": "production",
                "description": "Older immutable pinned snapshot of bee-comb, superseded by bee-comb-20260827-r1 as the current_snapshot (GET /bee/models, 2026-09-28). Roster-listed only."
            },
            "bee-comb-20260827-r1": {
                "vision": false,
                "status": "production",
                "description": "Current immutable pinned snapshot behind the bee-comb alias (GET /bee/models, 2026-09-28). Roster-listed only."
            },
            "bee-buzz": {
                "contextWindow": 256000,
                "pricingPerMTok": {
                    "input": 2.5,
                    "output": 10.0
                },
                "vision": false,
                "status": "production",
                "description": "Bee Buzz 1.0 — HEOSSI's 'Popular' Workspace tier ($400/mo) / $2.50 / $10.00 per 1M input/output tokens on the API track (https://bee.heossi.com/pricing, retrieved 2026-09-28). Context 256K, with the same 1,010,000-token routed long-context mode documented for Comb and Buzz (2026-07-11 changelog). Named alongside Comb and Hive in the 2026-07-11 changelog's tool-calling/JSON-mode-live announcement. Fallback; roster-verified only, not capability-probed."
            },
            "bee-buzz-20260710-r1": {
                "vision": false,
                "status": "production",
                "description": "Immutable pinned snapshot behind the bee-buzz alias (GET /bee/models, 2026-09-28). Roster-listed only."
            },
            "bee-hive": {
                "contextWindow": 256000,
                "pricingPerMTok": {
                    "input": 5.0,
                    "output": 20.0
                },
                "vision": false,
                "status": "production",
                "description": "Bee Hive 1.0 — $1,000/mo Workspace tier with a 99.5% SLA, or $5.00 / $20.00 per 1M input/output tokens on the API track (https://bee.heossi.com/pricing, retrieved 2026-09-28). Base context 256K; the same pricing page says Hive reaches a 1M-token mode 'via Comb', a routing detail not modeled as this entry's context window. Named alongside Comb and Buzz in the 2026-07-11 changelog's tool-calling/JSON-mode-live announcement. Fallback; roster-verified only, not capability-probed."
            },
            "bee-hive-20260710-r1": {
                "vision": false,
                "status": "production",
                "description": "Immutable pinned snapshot behind the bee-hive alias (GET /bee/models, 2026-09-28). Roster-listed only."
            },
            "bee-swarm": {
                "contextWindow": 1000000,
                "pricingPerMTok": {
                    "input": 25.0,
                    "output": 150.0
                },
                "vision": false,
                "status": "production",
                "description": "Bee Swarm 1.0 — top Workspace tier ($4,000/mo, 99.9% SLA) / $25.00 / $150.00 per 1M input/output tokens on the API track (https://bee.heossi.com/pricing, retrieved 2026-09-28). '1M natively' per the 2026-07-11 changelog. Not named in that changelog's Comb/Buzz/Hive tool-calling-and-JSON-mode announcement, so those capabilities are not assumed for this tier. Fallback; roster-verified only, not capability-probed."
            },
            "bee-swarm-20260710-r1": {
                "vision": false,
                "status": "production",
                "description": "Immutable pinned snapshot behind the bee-swarm alias (GET /bee/models, 2026-09-28). Roster-listed only."
            }
        },
        "topModels": [
            "bee-cell",
            "bee-brood",
            "bee-comb",
            "bee-buzz",
            "bee-hive",
            "bee-swarm"
        ]
    },
    "capabilities": {
        "text": true,
        "streaming": true,
        "tools": "model-dependent",
        "toolsWithStreaming": false,
        "structuredOutput": false,
        "structuredOutputWithTools": false,
        "embeddings": false,
        "thinking": true
    },
    "errorRules": [
        {
            "status": 401,
            "class": "authentication",
            "message": "Invalid Bee API key. Check {apiKeyEnvVar}. Get one at {setupUrl}"
        },
        {
            "status": 402,
            "class": "provider",
            "message": "Bee account has insufficient funded usage credit. Top up your prepaid wallet at https://bee.heossi.com/pricing"
        },
        {
            "status": 403,
            "class": "provider",
            "message": "The requested Bee model or capability is not included in your current plan. Upgrade at https://bee.heossi.com/pricing or {setupUrl}"
        },
        {
            "status": 429,
            "class": "rate-limit",
            "message": "Bee API allowance or rate limit reached. Wait and retry, or review your plan's usage caps at https://bee.heossi.com/pricing"
        }
    ],
    "setup": {
        "url": "https://workspace.bee.heossi.com/account/api-keys",
        "apiKeyFormat": null,
        "billingPolicy": "free-tier",
        "instructions": [
            "1. Visit: https://workspace.bee.heossi.com/account/api-keys and sign in (or create a Bee Workspace account)",
            "2. Create an API key — the free Bee Cell / Bee Pollen tier needs no credit card ('Free hosted access — no card', https://bee.heossi.com/pricing)",
            "3. Higher tiers (Brood/Comb/Buzz/Hive/Swarm) draw from a prepaid wallet billed per token; see https://bee.heossi.com/pricing for current rates",
            "4. Set {apiKeyEnvVar} in your .env file"
        ],
        "description": "OpenAI-compatible endpoint at https://api.bee.heossi.com/bee — note the base path is /bee, not /v1. Six model tiers (Cell through Swarm); the free Cell/Pollen tier requires no card, paid tiers meter a prepaid wallet per token (https://bee.heossi.com/pricing)."
    },
    "evidence": {
        "rosterVerified": {
            "date": "2026-09-28",
            "method": "unauthenticated GET https://api.bee.heossi.com/bee/models — 13 models; credential-free, no key used",
            "status": 200
        },
        "liveMatrix": null,
        "addedInPR": "https://github.com/juspay/neurolink/pull/1848"
    }
}