Upload problems
- A large file will not upload through the API: use the signed upload flow. It explains how to upload the file, notify ViddyScribe, and check when it is ready.
upload_not_ready: the media is still being verified. Check upload status before requesting generation again.upload_failedorno_video_stream: see upload errors and job failure errors for the next step.file_too_largeorvideo_too_long: check the input-limit errors.
API key or request rejected
For401 Unauthorized, check that you are sending your API key in the X-API-Key header. Follow the authentication guide or find out how to get an API key.
For 400, 403, or 404, read the response’s error message and compare it with the API error reference. The common error payloads explain invalid settings and plan restrictions.
Job queued or taking longer than expected
See the processing-time FAQ. Through the API, use your job ID to check the result. If you receive429, check the specific error: rate, queue, concurrency, and plan limits need different responses. See common error payloads and rate limits.
