Error types
- Permanent errors — The problem won’t resolve by retrying. You need to fix the underlying issue. Credits are automatically refunded.
- Temporary errors — A transient issue that usually resolves by clicking Retry. If the error persists after 2–3 retries, contact support.
- Permanent errors
- Temporary errors
These errors indicate a problem with the input. Credits are automatically refunded.
| Code | Title | Description | Action |
|---|---|---|---|
video_private | Video not accessible | The video is private or restricted | Make the video public or unlisted on YouTube |
video_deleted | Video not found | The video has been deleted or removed | Re-upload the video |
video_unavailable | Video unavailable | The video is currently unavailable | Check the source and try again later |
video_age_restricted | Age-restricted video | Requires age verification | Use a non-age-restricted video |
video_blocked | Video blocked | Blocked due to copyright or regional restrictions | Use a different video or check regional availability |
no_audio | No audio track | No audio track found in the video | Upload a video that contains an audio track |
no_speech | No speech detected | No speech detected in the audio | Ensure the video contains spoken content |
audio_too_short | Audio too short | Audio is too short to generate captions | Use a video with longer spoken content |
invalid_url | Invalid URL | Not a valid YouTube video URL | Check the URL format and try again |
unsupported_format | Unsupported format | Video format not supported | Convert to MP4 (H.264) and re-upload |
invalid_input | Invalid input | Input data is invalid or incomplete | Check your settings and try again |
music_detected | Music content detected | Primarily music, not supported for dubbing | Voice dubbing requires spoken content |
missing_api_key | Configuration error | Required service not configured | Contact support |
invalid_api_key | Configuration error | Required service misconfigured | Contact support |
config_error | Configuration error | Internal configuration error | Contact support |
Automatic refunds
All failed jobs — whether permanent or temporary errors — are automatically refunded. You don’t need to contact support. Refunds appear immediately in your credit history.Checkpoint-based retry
When you retry a job, Neolli resumes from the last checkpoint rather than starting over. This means:- Faster retries — Completed work is preserved
- Lower cost — You’re only charged for work that actually completes
- Better success rate — Transient issues typically don’t recur on retry