mirror of
https://github.com/enricoros/big-AGI.git
synced 2026-05-10 21:50:14 -07:00
paulhshort
9fe5697fd4
This commit addresses GitHub issue #828 by fixing URL construction for Azure OpenAI's Responses API and preventing malformed URLs from client configuration issues. ## Problems Fixed: 1. Host normalization: Prevents malformed URLs when client config includes paths/queries 2. API paradigm support: Properly handles Azure's next-gen v1 Responses API 3. API version consistency: Centralizes version management with env overrides ## Key Changes: - Normalize Azure host URLs to origin only (strip path/query) - Prefer server environment variables over client-provided hosts - Add special handling for Responses API (/openai/v1/responses) - Support both traditional (deployment-based) and v1 API paradigms - Add configurable API versions via environment variables - Include debug logging for API paradigm selection ## New Environment Variables: - AZURE_API_V1: Enable next-gen v1 API explicitly - AZURE_RESPONSES_API_VERSION: Control Responses API version - AZURE_CHAT_API_VERSION: Control Chat Completions API version - AZURE_DEPLOYMENTS_API_VERSION: Control deployments listing API version ## Testing: Validated with Azure OpenAI endpoint showing: - List Deployments: ✅ Works - Chat Completions: ✅ Works (with correct params for GPT-5) - Responses API (v1): ✅ Works with /openai/v1/responses?api-version=preview - Responses API (traditional): ❌ 404 (Azure doesn't support this pattern) The fix defaults to using Azure's recommended next-gen v1 API for Responses while maintaining backward compatibility for existing deployments. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Big-AGI Documentation
Information you need to get started, configure, and use big-AGI productively.
Getting Started
Essential guides:
- FAQ: Common questions and answers
- Enabling Microphone: Configure speech recognition in your browser
AI Services
How to set up AI models and features in big-AGI.
👉 The following applies to users of big-AGI.com, as the public instance is empty and requires user configuration.
-
Cloud AI Services:
- Easy API key configuration: Alibaba, Anthropic, Deepseek, Google Gemini, Groq, Mistral, OpenAI, OpenPipe, Perplexity, TogetherAI, xAI
- Azure OpenAI guide
- FireworksAI (API keys, via custom OpenAI endpoint: https://api.fireworks.ai/inference)
- OpenRouter guide
-
Local AI Integrations:
-
Enhanced AI Features:
- Web Browsing: Enable web page download through third-party services or your own cloud
- Web Search: Google Search API (see 'Environment Variables')
- Image Generation: GPT Image (gpt-image-1), DALL·E 3 and 2
- Voice Synthesis: ElevenLabs API for voice generation
Deployment & Customization
👉 The following applies to developers and experts who deploy their own big-AGI instance.
For deploying a custom big-AGI instance:
-
Installation Guide, including:
- Set up your own big-AGI instance
- Source build or pre-built options
- Local, cloud, or on-premises deployment
-
Advanced Setup:
- Source Code Customization: Modify the source code
- Access Control: Optional, add basic user authentication
- Database Setup: Optional, enables "Chat Link Sharing"
- Reverse Proxy: Optional, enables custom domains and SSL
- Environment Variables: Pre-configures models and services
Community & Support
- Visit our GitHub repository for source code and issue tracking
- Check the latest updates in the Changelog or in-app News
- Join our Discord for discussions and help
Let's build something great.