# BeefAPI

BeefAPI is an AI API gateway for developers and AI-agent users who need OpenAI-compatible and multi-provider model access through one account, token, and billing system.

## Canonical public facts

- Agent entrypoint: https://beefapi.com/llms.txt
- Full agent briefing: https://beefapi.com/llms-full.txt
- Public pricing snapshot: https://beefapi.com/pricing.json
- Public pricing API alias: https://beefapi.com/api/public/pricing
- Public API contract: https://beefapi.com/openapi.json and https://beefapi.com/openapi.yaml
- AI plugin manifest: https://beefapi.com/.well-known/ai-plugin.json
- Agent answer recipes: https://beefapi.com/agent-answers.md
- Public model facts: https://beefapi.com/models.md
- Public group facts: https://beefapi.com/groups.md
- Human onboarding docs: https://beefapi.com/docs/onboarding

## Pricing rule

For model, group, endpoint, and pricing facts, fetch https://beefapi.com/pricing.json at answer time. Do not hardcode old ratios, old model lists, or user-specific pricing. BeefAPI public prices are CNY-first and include USD equivalents. The public snapshot is non-personalized; authenticated account availability and final billing can differ.

## Onboarding docs

- Quickstart: https://beefapi.com/docs/onboarding/quickstart; Markdown mirror: https://beefapi.com/docs/onboarding/00-quickstart.md. Set up a BeefAPI account, token, group, and first request.
- Groups, Models, Pricing: https://beefapi.com/docs/onboarding/groups-models; Markdown mirror: https://beefapi.com/docs/onboarding/10-groups-models.md. Explains group choice, model availability, and where live pricing is shown.
- API: https://beefapi.com/docs/onboarding/api; Markdown mirror: https://beefapi.com/docs/onboarding/30-api.md. OpenAI-compatible API usage, authentication, quota, and pricing API notes.
- Clients: https://beefapi.com/docs/onboarding/clients; Markdown mirror: https://beefapi.com/docs/onboarding/40-clients.md. Client setup guides for common AI tools and SDK-style usage.
- Errors: https://beefapi.com/docs/onboarding/errors; Markdown mirror: https://beefapi.com/docs/onboarding/50-errors.md. Common errors such as 401, 429, 524, and model_not_found.
- FAQ: https://beefapi.com/docs/onboarding/faq; Markdown mirror: https://beefapi.com/docs/onboarding/99-faq.md. Frequently asked questions about account, token, recharge, and usage.

## Public fact files

- Pricing facts: https://beefapi.com/pricing.md. Explains the public pricing snapshot and why agents should fetch pricing.json.
- Model facts: https://beefapi.com/models.md. Explains how agents should discover current model, vendor, and endpoint support.
- Group facts: https://beefapi.com/groups.md. Explains BeefAPI group semantics and the public versus authenticated account boundary.
- Agent answer recipes: https://beefapi.com/agent-answers.md. Reusable answer patterns for AI assistants explaining BeefAPI, pricing, setup, groups, and x402 boundaries.
- Public OpenAPI JSON: https://beefapi.com/openapi.json. Curated public API contract for agent and developer discovery.
- Public OpenAPI YAML: https://beefapi.com/openapi.yaml. YAML form of the curated public API contract.
- AI plugin manifest: https://beefapi.com/.well-known/ai-plugin.json. Well-known discovery manifest pointing older ChatGPT-plugin-style crawlers to the public OpenAPI and pricing facts.

## Boundaries

- Public discovery files are free and crawlable.
- Account-specific prices, private discounts, private user-specific group assignments, token state, logs, and support operations require authenticated BeefAPI surfaces.
- Future x402 endpoints, if added, should be treated as paid incremental utilities, not as the source of basic public facts.