Get Task Status

Fetch task status by ID. Poll this endpoint until the task completes.

Request

curl -X GET "https://undressme.ai/api/tasks-status?taskId=<TASK_ID>" \
  -H "Authorization: Bearer <API_KEY>"

200 Response

• status: processing | completed | error

processing

{
  "status": "processing",
  "resultUrl": null,
  "progress": 42
}

• progress: only for processing, estimated 0-99

completed

{
  "status": "completed",
  "resultUrl": "https://..."
}

• resultUrl: valid when completed

error

{
  "status": "error",
  "resultUrl": null,
  "creditsRemaining": 120
}

• creditsRemaining: returned when the task ends in error (including timeouts)

Timeout and Refund

• Default timeout is 4 minutes. On timeout, the task is marked error and credits are refunded.

Error Responses

• 400 Task ID is required
• 401 Authentication required
• 404 Task not found (or not owned by the user)
• 429 Rate limit exceeded
• 500 The system is busy, please try again later