Overview
Get the current processing status of a video project. This is a lightweight endpoint that returns essential status information for monitoring project progress without fetching full project details.Query Parameters
Unique identifier of the project to check
Response
The unique identifier of the project
Type of project (“clipping”, “captions”, “reframe”, or “dubbing”)
Source of the original video (“youtube”, “user_upload”, or “external”)
Current processing status of the project
Project Status Values
Project is currently being processed by our AI systems
Project has finished processing successfully - clips are ready
Project processing failed due to an error
Project was cancelled before completion
Project Type Values
AI-powered short clip generation from long-form videos
Caption generation and styling for videos
Video reframing for different aspect ratios
Voice dubbing and translation services
Example Request
Example Response
Polling for Status Updates
For real-time monitoring, you can poll this endpoint at regular intervals:Processing Times
Typical processing times by project type:Clipping Projects
5-15 minutes depending on video length and complexity
Caption Projects
2-5 minutes for most video lengths
Reframe Projects
3-8 minutes depending on video length
Dubbing Projects
10-20 minutes depending on video length and language pair
Rate Limiting
This endpoint is subject to the standard rate limit of 10 requests per minute.Best Practices
Polling Guidelines:
- Poll every 5-10 seconds for active monitoring
- Use exponential backoff for long-running projects
- Handle rate limits gracefully in your polling logic
- Consider using webhooks for production applications
Common Use Cases
Progress Monitoring
Track project progress in real-time user interfaces
Automated Workflows
Build automated systems that wait for project completion
Status Dashboards
Create monitoring dashboards for multiple projects
Error Handling
Detect and handle failed projects in your applications
Next Steps
Based on the project status:- Processing: Continue monitoring or check Get Project Details
- Completed: Retrieve results with Get Project Clips
- Failed: Review project details and retry if needed