Skip to main content
GET
/
v1
/
video
/
remove-background
/
job
/
{jobId}
Video Remove Background Job Status
curl --request GET \
  --url https://api.developer.pixelcut.ai/v1/video/remove-background/job/{jobId} \
  --header 'X-API-KEY: <api-key>'
{
  "job_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "status": "completed",
  "result_url": "https://assets.pixelcut.app/public/result/video-abc123.mp4",
  "error": {
    "code": "unexpected_error",
    "message": "Job processing failed"
  }
}

Authorizations

​
X-API-KEY
string
header
required

All API requests require a valid api key. Include your token as a HTTP request header in the following format: X-API-Key: skXXXXXXXXXXXXXXXX. You can obtain an api key by signing up for developer access in your Pixelcut account.

Path Parameters

​
jobId
string
required

The ID of the job to check

Response

Job status retrieved successfully

​
job_id
string

The ID of the job

Example:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

​
status
enum<string>

The current status of the job

Available options:
pending,
running,
completed,
failed
Example:

"completed"

​
result_url
string

A URL to access the resultant video, only present when status is 'completed'

Example:

"https://assets.pixelcut.app/public/result/video-abc123.mp4"

​
error
object