Images

Remove image background (async)

Queue a background removal for an image: a library file_uuid or the image inline as base64 in image_data; exactly one of the two. JPEG, PNG or WebP. Uses AI triangulation matting (two Gemini passes + per-pixel alpha computation). Returns immediately with a job_id - poll GET /v1/jobs/{id} until status is completed; the result carries file_uuid and download_url of the PNG. This route answered synchronously before 2026-10-09 - see x-breaking-changes.

Cost: 0.20 credits per call, reserved when the job is queued.

post/v1/images/remove-background

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/images/remove-background
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Request body

file_uuidstring uuid

UUID of an image file in your library (JPEG, PNG, or WebP). Use this or image_data.

image_datastring

The image inline, as base64 or a data URL (JPEG, PNG, or WebP). Use this or file_uuid.

subject_hintstring

Optional hint to identify the subject, e.g. "the person" or "the car".

Response

Job queued

successboolean
timestampstring date-time

Example response

{
  "success": true,
  "data": {
    "status": "pending"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.