Add Support for Custom Headers

[maerch]

• Introduces a common provider configuration as a starting point for all provider
• Adds headers configuration to all available providers

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
plugins-web	✅ Ready (Inspect)	Visit Preview	Jun 5, 2025 7:53am

[Copilot]

Pull Request Overview

This PR introduces support for custom HTTP headers for all providers. Key changes include the addition of a headers field to the common provider configuration, updates to merge custom headers into API requests across multiple provider files, and corresponding documentation updates in the tutorial and README.

Reviewed Changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/plugin-ai-video-generation-web/src/fal-ai/createVideoProvider.ts	Adds headers support and merges custom headers in video provider initialization.
packages/plugin-ai-video-generation-web/src/fal-ai/PixverseV35TextToVideo.ts	Passes custom headers to the provider configuration.
packages/plugin-ai-video-generation-web/src/fal-ai/MinimaxVideo01LiveImageToVideo.ts	Propagates headers into the provider initialization.
packages/plugin-ai-video-generation-web/src/fal-ai/MinimaxVideo01Live.ts	Adds headers to configuration for live video processing.
packages/plugin-ai-text-generation-web/src/anthropic/sendPrompt.ts	Merges custom headers into Anthropics API requests and adjusts header types.
packages/plugin-ai-text-generation-web/src/anthropic/AnthropicProvider.ts	Passes headers from the configuration to the API call.
packages/plugin-ai-image-generation-web/src/open-ai/GptImage1.text2image.ts	Adds headers to API request configurations for image generation.
packages/plugin-ai-image-generation-web/src/open-ai/GptImage1.image2image.ts	Merges custom headers into the API request for image-to-image operations.
packages/plugin-ai-image-generation-web/src/fal-ai/createImageProvider.ts	Integrates custom headers into image provider initialization.
packages/plugin-ai-generation-web/src/fal-ai/RecraftV3.ts	Adds custom headers into provider initialization for image generation.
packages/plugin-ai-generation-web/src/fal-ai/GeminiFlashEdit.ts	Passes headers to the provider for flash edit features.
packages/plugin-ai-generation-web/src/index.ts	Re-exports the updated CommonProviderConfiguration.
packages/plugin-ai-generation-web/src/generation/types.ts	Defines the CommonProviderConfiguration interface with the headers field.
packages/plugin-ai-generation-web/TUTORIAL.md	Updates tutorial sections to document the new headers configuration and its usage.
packages/plugin-ai-generation-web/README.md	Enhances documentation to include examples for setting custom headers.
packages/plugin-ai-audio-generation-web/src/elevenlabs/ElevenSoundEffects.ts	Merges custom headers in audio API requests.
packages/plugin-ai-audio-generation-web/src/elevenlabs/ElevenMultilingualV2.ts	Integrates custom headers into audio generation requests.
CHANGELOG-AI.md	Adds an entry documenting the new custom headers support feature.

Comments suppressed due to low confidence (3)

packages/plugin-ai-video-generation-web/src/fal-ai/createVideoProvider.ts:64

• [nitpick] Confirm that the custom headers merging order meets the intended precedence and document whether custom headers should override the defaults or vice versa.

headers: { ...request.headers, ...(options.headers ?? {}) }

packages/plugin-ai-text-generation-web/src/anthropic/sendPrompt.ts:56

• Review header type definitions for consistency; consider aligning the header type in sendPrompt with that in CommonProviderConfiguration to ensure uniformity.

headers: { ...(DEFAULT_ANTHROPIC_OPTIONS.headers ?? {}), ...config.headers }

packages/plugin-ai-generation-web/README.md:49

• [nitpick] Ensure that the documentation clearly explains the header merge behavior and the significance of header ordering when combining custom headers with required defaults.

headers: { 'x-custom-header': 'value', 'x-client-version': '1.0.0' }