Back to Help

faq

Help FAQ

Common questions across product usage, API integration, and CLI automation.

Audience: both

Product FAQ

Which plan is best for production-quality voices?

If your primary goal is publish-ready narration quality, start with Pro. Use Starter when you only need to test workflow and speed.

How do I update existing videos quickly?

Edit only changed slides, regenerate affected audio, then re-render. Avoid full rework unless structure or voice strategy changed.

What format should I use?

Use landscape for YouTube/LMS/desktop training. Use portrait for mobile-first channels.

API FAQ

How do I authenticate API calls?

Use x-api-key for automation, or bearer token for interactive workflows.

Why am I getting 403 on /v1/*?

API access is tier-gated. Confirm the account has Pro/Max access and valid credentials.

Should I poll or use webhooks?

Use polling for simple workflows and quick scripts. Use webhooks for production async pipelines.

CLI FAQ

Is there a way to script CLI output reliably?

Yes. Use --json and parse output in CI scripts.

Where does the CLI store credentials?

On macOS it uses Keychain when available; otherwise use env vars and secure local credentials file behavior.

Can I use CLI with coding agents?

Yes. Use command-first prompts and request stop-on-error behavior. See: