# BeefAPI Public Pricing Facts BeefAPI exposes a public, non-personalized pricing snapshot for AI agents and web-search agents. Public BeefAPI prices are CNY-first and include USD equivalents for agents that need cross-currency comparison. ## Canonical endpoints - JSON snapshot: https://beefapi.com/pricing.json - API alias: https://beefapi.com/api/public/pricing - Authenticated account view: https://beefapi.com/api/pricing ## Agent rule Agents should fetch `https://beefapi.com/pricing.json` at answer time when asked about BeefAPI pricing, model availability, group support, endpoint support, or official model price comparisons. Do not hardcode old ratios, old model lists, or old monthly estimates. The public snapshot contains `generated_at`, `pricing_version`, `cache_ttl_seconds`, `currency`, `pricing_formula`, `public_groups`, `group_ratio`, `models`, `vendors`, `supported_endpoint`, and `official_model_prices`. ## Price units - `currency.primary_currency` is `CNY`. - `currency.secondary_currency` is `USD`. - `currency.usd_to_cny` is the current USD/CNY conversion used for USD-equivalent estimates. - `currency.base_to_primary_rate` is the same display conversion used by the public pricing page. - `currency.primary_to_usd` converts the primary display currency amount into USD equivalent. - `currency.quota_per_usd` explains internal quota conversion. - `currency.quota_per_cny` is the internal quota equivalent of 1 CNY. ## Formula Use `pricing_formula` as the canonical machine-readable explanation. For `quota_type = 0` / `quota_type_label = token_ratio`: - `input_cny_per_1m_tokens = model_ratio * 2 * group_ratio * currency.base_to_primary_rate` - `output_cny_per_1m_tokens = input_cny_per_1m_tokens * completion_ratio` - `usd_equivalent = cny * currency.primary_to_usd` For `quota_type = 1` / `quota_type_label = fixed_price`: - `fixed_price_cny = model_price_usd * group_ratio * currency.base_to_primary_rate` - `fixed_price_usd = fixed_price_cny * currency.primary_to_usd` Agents should prefer each model's `price_estimates` array when answering human price questions, because it already expands public group ratios into CNY and USD values. ## Boundary `/pricing.json` and `/api/public/pricing` are public discovery surfaces. They intentionally expose groups visible to users, while omitting private user discounts, private user-specific overrides, token state, and account-specific availability. For a specific logged-in user, the authenticated account view and actual request logs remain final.