Troubleshooting

Product Issues

Render stuck or slow

1. Confirm timeline has valid slide content and generated audio.
2. Retry render once.
3. If repeated, capture render ID and contact support.

Narration quality issues

1. Change voice profile first.
2. Adjust speed slightly.
3. Rewrite problematic sentence and regenerate affected slides.

Visual layout issues

1. Reduce text density.
2. Verify format choice (landscape vs portrait).
3. Re-render after template adjustments.

API Issues

401 Unauthorized

• Verify x-api-key or bearer token is present and current.
• Verify requests are sent to /v1/* base URL.

403 Forbidden

• Confirm account tier supports public API access.
• Confirm user has access to target resources.

409 Idempotency conflict

• Reused idempotency key with different payload.
• Use a new key for materially different request bodies.

429 Rate limit

• Respect Retry-After.
• Back off and retry with jitter.

CLI Issues

slidevids whoami fails

1. Re-run slidevids login.
2. Check SLIDEVIDS_API_BASE_URL and auth env vars.
3. Run with --debug to inspect request path/status.

Render waits indefinitely

1. Use explicit timeout in renders wait.
2. Check render status directly with renders status.
3. Verify timeline ID and render ID match expected environment.

Escalation Data to Capture

When opening a support request include:

1. Timeline ID and render ID.
2. Approximate timestamp and timezone.
3. Request IDs from failing API calls.
4. CLI command used and error output.

Contact: /contact