Lifecycle states
| State | Meaning |
|---|---|
| uploading | File received and being validated |
| queued | Submitted to the provider, waiting to start |
| processing | Provider is generating the result |
| finalising | Downloading the result, re-attaching audio, applying watermark if required |
| done | Ready to preview and download |
| failed | An error occurred; credits are refunded |
Step by step
- Validation: file extension, MIME type, size up to 200 MB and duration against your plan are checked using ffprobe when available, and the browser reports duration as a fallback.
- Credits: the rounded-up duration in seconds is reserved from your balance.
- Upload to provider storage and submit to the fal.ai queue with model decart/lucy-restyle and your style prompt.
- Polling: the project page asks our server for status every few seconds; the server queries the provider.
- Finalisation: when complete, the server downloads the 720p MP4 to storage, re-attaches the original audio if ffmpeg is available, and creates a thumbnail.
- Delivery: preview and download are served from our storage.
What can go wrong
- Provider error: job marked failed, credits refunded
- Missing provider credentials: the converter shows a clear configuration error and no credits are charged
- Missing ffmpeg: results are delivered silent because the original audio cannot be re-attached, and the project page says so