14 — Settings Reference
Open Settings by clicking the ⚙️ icon in the top-right header bar. Settings are organized into four tabs: API Keys, Cloud Storage, Export, and License.
All settings are stored locally on your machine and are never sent to HF servers.
Tab 1: API Keys
Configure your third-party API keys. Each field includes a direct link to the provider’s key management page — click the link to open it in your system browser.
| Key | Provider Link | Used For |
|---|---|---|
| Replicate API Key | replicate.com/account/api-tokens | All AI image, video, talking head, audio, and voice synthesis features |
| OpenAI API Key | platform.openai.com/api-keys | Whisper transcription; GPT-Image-1 and GPT-Image-1 Mini models |
| Google Cloud API Key | console.cloud.google.com/apis/credentials | Google Cloud Speech-to-Text transcription |
| Gemini API Key | aistudio.google.com/apikey | Gemini transcription; AI text polish in Voice Studio |
Minimum to get started: You only need the Replicate key to use most AI generation features. Add others as you need the specific features they unlock.
Tab 2: Cloud Storage
Cloud storage is required when the app needs to host a file at a publicly accessible URL — specifically for Talking Head and Long-Form Pipeline reference image uploads.
Supported providers:
– AWS S3
– Cloudflare R2 (S3-compatible)
– Any other S3-compatible service (e.g., MinIO)
| Field | Description |
|---|---|
| Storage Type | Select your provider from the dropdown |
| Access Key ID | Your S3/R2 access key |
| Secret Access Key | Your S3/R2 secret key |
| Bucket Name | The name of your storage bucket |
| Region | AWS region (e.g., us-east-1); may not be needed for R2 |
| Base URL | Custom domain or endpoint URL (required for Cloudflare R2 and S3-compatible services; optional for AWS) |
Important: Your S3 bucket must be configured with CORS headers to allow browser-based uploads. Without these, uploads will fail. Refer to your provider’s documentation or the docs/AWS_S3_SETUP.md file for step-by-step setup instructions.
Tab 3: Export
| Setting | Description |
|---|---|
| Default Export Folder | Where exported files are saved (default: system Downloads folder) |
| Custom Folder Path | Override the default by entering or browsing to a folder path |
File naming: Exports are automatically named with a timestamp, for example: edited_video_20260413_143022.mp4. This prevents overwrites between exports.
Tab 4: License
| Action | Description |
|---|---|
| License Key | Enter your key and click Activate to validate |
| Account Status | Shows whether your license is active, expired, or pending |
| Renewal | Links to the purchase/renewal page if your license is expiring |
If your license key is rejected, verify you are entering it exactly as it appeared in your purchase confirmation email. Contact support if the issue persists.
Previous: Job Queue | Next: Exporting →