API Reference
Text Generation
Audio Generation
Video Generation
Results
curl --request GET \
--url https://api.viddyscribe.com/enterprise/api/get_upload_status \
--header 'X-API-Key: <api-key>'{
"media_id": "550e8400-e29b-41d4-a716-446655440000",
"canonical_media_id": "550e8400-e29b-41d4-a716-446655440000",
"upload_status": "completed",
"duration_seconds": 45.5,
"frame_rate": 30
}Get signed upload status
Return the current verification status for a media item uploaded via the signed upload flow.
Use this to confirm the upload is ready before calling a generation endpoint with media_id.
curl --request GET \
--url https://api.viddyscribe.com/enterprise/api/get_upload_status \
--header 'X-API-Key: <api-key>'{
"media_id": "550e8400-e29b-41d4-a716-446655440000",
"canonical_media_id": "550e8400-e29b-41d4-a716-446655440000",
"upload_status": "completed",
"duration_seconds": 45.5,
"frame_rate": 30
}Documentation Index
Fetch the complete documentation index at: https://docs.viddyscribe.com/llms.txt
Use this file to discover all available pages before exploring further.
Usage Example
Poll this endpoint afternotify_upload_complete until the upload has finished verification and the media is ready for generation.
curl "https://api.viddyscribe.com/enterprise/api/get_upload_status?media_id=550e8400-e29b-41d4-a716-446655440000&gcs_path=users/user_123/videos/video.mp4" \
-H "X-API-Key: YOUR_API_KEY"
Authorizations
API key for authentication. Obtain from your team admin.
Example: X-API-Key: vsk_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz
Query Parameters
Media ID returned by upload_media
Optional storage path returned by upload_media; helps recover the canonical media if deduplication occurred
Response
Upload status returned successfully
Original media ID provided by the client
Canonical media ID to use for generation
Current verification status for the uploaded media
Video duration in seconds when available
Video frame rate (fps) when available