# Halfred Docs

## Landing Page

- [Welcome to Halfred Documentation](https://docs.halfred.ai/readme.md): Developer-focused AI infrastructure platform that simplifies access to powerful large language models through intelligent routing, prebuilt SDKs, and profile-based abstraction.
- [Getting Started](https://docs.halfred.ai/01-getting-started.md): Get up and running with Halfred in less than 5 minutes. Complete guide from account creation to your first API call.
- [Quick Start Guide](https://docs.halfred.ai/01-getting-started/01-quickstart.md): Get started with Halfred in less than 5 minutes. Learn how to create an account, generate an API key, and make your first API call.
- [Authentication](https://docs.halfred.ai/01-getting-started/02-authentication.md): Learn how to authenticate your requests to the Halfred API using API keys, manage them securely, and follow security best practices.
- [SDK Integration](https://docs.halfred.ai/02-sdk-integration.md): Multiple integration options for Halfred including native SDKs for Node.js and Python, plus OpenAI SDK compatibility.
- [Halfred Node.js SDK](https://docs.halfred.ai/02-sdk-integration/01-nodejs.md): Official Halfred SDK for Node.js and TypeScript with modern JavaScript features, full type support, and easy integration.
- [Halfred Python SDK](https://docs.halfred.ai/02-sdk-integration/02-python.md): Official Halfred SDK for Python applications with modern features, type hints, and easy integration.
- [OpenAI SDK Compatibility](https://docs.halfred.ai/02-sdk-integration/03-openai-compatibility.md): Use Halfred as a drop-in replacement for OpenAI with existing OpenAI SDK libraries. Simply point your client to Halfred's endpoint.
- [Core Concepts](https://docs.halfred.ai/03-concepts.md): Understanding Halfred's key concepts including model profiles, pricing, credits, and tokens for optimal AI integration.
- [Model Profiles](https://docs.halfred.ai/03-concepts/01-profiles.md): Understand Halfred's model profiles - Lite, Standard, DeepThink, and Dev. Choose the right profile for your use case and budget.
- [Pricing & Credits](https://docs.halfred.ai/03-concepts/02-pricing.md): Understand Halfred's transparent prepaid credit system, profile pricing, cost calculation, and optimization strategies.
- [Tokens Explained](https://docs.halfred.ai/03-concepts/03-tokens.md): Learn what tokens are, why they matter for billing and performance, and how to optimize token usage in your AI applications.
- [API Reference](https://docs.halfred.ai/04-api-reference.md): Complete REST API documentation for Halfred including endpoints, authentication, request/response formats, and error handling.
- [Halfred API Reference](https://docs.halfred.ai/04-api-reference/01-endpoints.md): Complete REST API reference for Halfred including chat completions, models endpoint, request parameters, and response formats.
- [Error Handling](https://docs.halfred.ai/04-api-reference/02-errors.md): Complete guide to Halfred API error responses, HTTP status codes, common errors, and best practices for error handling.
- [Advanced Topics](https://docs.halfred.ai/05-advanced.md): Advanced guides and best practices for optimizing performance, cost-efficiency, and reliability in your Halfred integration.
- [Best Practices](https://docs.halfred.ai/05-advanced/01-best-practices.md): Optimize your Halfred integration for performance, cost-efficiency, and reliability with proven strategies and patterns.
