Endpoint
Copy
POST https://api.ugc.inc/render/status
Overview
Check the status of a render job submitted via/render/submit. Poll this endpoint until the status is completed or failed.
Request Body
The job ID returned from the submit endpoint
Response
Job status information
Show Status properties
Show Status properties
The job identifier
Current job status
pending: Job queued, waiting to startprocessing: Job is currently renderingcompleted: Job finished successfullyfailed: Job encountered an error
Type of output being rendered
Progress percentage (0-100)
Status message describing current state
Job creation timestamp (Unix time)
Last update timestamp (Unix time)
Download URL for the rendered file (only present when
status: 'completed')File size in bytes (only present when completed)
Total render time in milliseconds (only present when completed, video only)
Completion timestamp (only present when completed)
Error message (only present when failed)
Copy
curl -X POST https://api.ugc.inc/render/status \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"job_id": "550e8400-e29b-41d4-a716-446655440000"}'
Copy
{
"ok": true,
"code": 200,
"message": "Success",
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"output_type": "video",
"progress": 45,
"message": "Rendering frames...",
"created_at": 1700000000.123,
"updated_at": 1700000015.456
}
}