Skip to Content
APICreate Task

Create Task

Create a task and start processing.

Request

curl -X POST "https://undressme.ai/api/tasks-create" \ -H "Authorization: Bearer <API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "type": "undress", "sourceKey": "ugc/<uuid>" }'
  • sourceKey is the key returned by Presign Upload URL.
  • The same sourceKey can be reused for multiple tasks.
  • type must be one of Task Types. In the current implementation, an invalid type becomes a server error (500).

200 Response

{ "taskId": "uuid", "status": "processing", "creditsRemaining": 123 }
  • taskId: Task identifier used to check status via Task Status.
  • status: Current state (always processing).
  • creditsRemaining: Credits left after the task is created.

Error Responses

  • 400 Invalid JSON body or missing sourceKey
  • 401 Authentication required
  • 402 Insufficient credits
  • 429 Rate limit exceeded
  • 500 The system is busy, please try again later
Last updated on