17 — Troubleshooting & FAQ

17 — Troubleshooting & FAQ

API Keys & Authentication

“Generate” button is disabled or grayed out

You are missing an API key required for the selected feature or model.
– Check Settings → API Keys and confirm the relevant key is entered and saved.
– For GPT-Image-1 and GPT-Image-1 Mini, an OpenAI API key is required in addition to a Replicate key.
– For AI Polish in Voice Studio, a Gemini API key is required.

Generation fails immediately with an auth error

Your API key may be invalid, expired, or over its usage limit.
– Verify the key by logging into the provider’s dashboard and checking its status.
– Generate a new key if needed, and update it in Settings → API Keys.

Whisper transcription fails

  • Confirm your OpenAI API key is entered in Settings.
  • Check that your OpenAI account has available credits.

Cloud Storage

Reference image upload fails (Talking Head / Long-Form)

Cloud storage is not configured or the bucket has a misconfiguration.
1. Open Settings → Cloud Storage and verify all fields are filled in correctly.
2. Confirm your bucket exists and is accessible with the credentials you provided.
3. Ensure your bucket has CORS headers configured. Without CORS, browser-based uploads are blocked. See docs/AWS_S3_SETUP.md for setup instructions.

“Access Denied” when uploading to S3

  • Your Access Key ID or Secret Access Key may be incorrect.
  • Your IAM policy may not include s3:PutObject permission for the target bucket.
  • Double-check your bucket name matches exactly (S3 bucket names are case-sensitive).

Generation Jobs

A job is stuck on “Running” for a long time

  • Most models complete within 1–5 minutes. If a job runs beyond 10 minutes without completing, the provider may be experiencing delays.
  • Check the provider’s status page (e.g., status.replicate.com) for outages.
  • You can safely generate a new job — the stuck job will eventually time out.

A job shows “Failed”

  • Click the job entry to see the error message.
  • Common causes: content policy violation, invalid model input, temporary provider outage, missing API key.
  • Adjust your prompt or inputs and try again.

Jobs disappear after reopening the app

Job history is stored in browser local storage. If local storage was cleared (e.g., by a browser privacy cleaner or a manual clear), job history is lost. The generated files themselves are not affected — download them to your computer when they complete.

Captions

Captions are out of sync with the audio

Use the Caption Offset control in the Captions panel to shift all captions forward or backward until they align.
– Use the -0.1s / +0.1s nudge buttons for fine adjustments.
– Use the -1s / +1s buttons for larger shifts.
– Click Reset to return to zero if you overshoot.

No captions appear after transcription

  • Captions require a completed Transcribe step in Voice Studio. Make sure you ran transcription and it returned a result.
  • Switch to the Captions panel only after transcription is complete.

Export & Rendering

Export is very slow

  • Export speed depends on project complexity (number of segments, overlays, caption count) and your CPU.
  • Videos with burned-in captions take longer because FFmpeg processes every frame.
  • For large projects, expect several minutes of render time. This is normal.

Exported video has no audio

  • Check that you have at least one audio clip on the audio track, or that the video segments have embedded audio and the volume is not set to 0%.
  • If you replaced audio via Voice Studio, confirm the synthesized clip was added to the timeline and not muted.

Exported video looks correct but captions are missing

  • Captions must be configured in the Captions panel before exporting. Simply having a transcription is not enough — you must open the Captions panel, configure the style, and verify captions appear in the preview.

General

The app feels slow or unresponsive during generation

AI generation is network-bound (requests to remote APIs), not CPU-bound. You can continue editing while jobs run in the background. If the UI itself is lagging, try closing other browser tabs or applications to free up RAM.

How do I update the app?

Download the latest installer from the official product page and run it. The installer will update the existing installation.

Where are my project files stored?

Project state is currently stored in the app’s local storage. Exports (MP4, MP3 files) are saved to the folder configured in Settings → Export (default: Downloads folder).

Can I use the app offline?

The video editor itself works offline. AI generation features (image, video, audio, voice synthesis, transcription) require an internet connection to contact the provider APIs.

Getting Help

If your issue is not covered here, contact support through the official product page or your account portal.

When contacting support, include:
– App version (shown in the header bar)
– A description of what you were doing
– Any error messages shown in the app or in the Job Queue

Previous: Common Workflows | Back to Table of Contents →