diff --git a/.env.example b/.env.example
index 73e7122b..dad70908 100644
--- a/.env.example
+++ b/.env.example
@@ -4,6 +4,17 @@
 # --- Image + video gateway ---
 FAL_KEY=                     # FLUX images, Google Veo video, Kling video, MiniMax video, Recraft images
                              # Get one at https://fal.ai/dashboard/keys
+FAL_AI_API_KEY=              # Alias for FAL_KEY (some SDKs/docs use this name); either one is read.
+
+# --- Replicate ---
+REPLICATE_API_TOKEN=         # Replicate-hosted video gen (seedance_replicate). Needed to make the
+                             # Replicate-backed Seedance path selectable alongside the fal.ai one.
+                             # Get one at https://replicate.com/account/api-tokens
+
+# --- Higgsfield ---
+HIGGSFIELD_API_KEY=          # Higgsfield Cloud key (higgsfield_video). Pair with the secret below,
+HIGGSFIELD_API_SECRET=       # or use the combined HIGGSFIELD_KEY="<key>:<secret>" form instead.
+# HIGGSFIELD_KEY=            # Combined key:secret — set this INSTEAD of the _KEY/_SECRET pair if you prefer.
 
 # --- Google (one key unlocks image gen + TTS) ---
 GOOGLE_API_KEY=              # Google Imagen images, Google Cloud TTS (700+ voices, 50+ languages)