> ## Documentation Index
> Fetch the complete documentation index at: https://askeditor.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Run: Remove Background (synchronous)

> Cut the subject out of a video: the person isolated on a true alpha channel, ready to composite anywhere. SYNCHRONOUS: the call returns the finished cutout (~40-90s), no polling. The reflex call when an agent needs a background gone.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/run/remove-background
openapi: 3.1.0
info:
  title: AskEditor Platform API
  version: 1.0.0-preview
  description: >-
    The video editing API for AI agents. Every response is wrapped as { success,
    data }. Templates are addressed by id; synchronous templates return their
    result in the run call, queued templates resolve through the jobs envelope.
servers:
  - url: https://api.askeditor.com
security:
  - bearerAuth: []
paths:
  /v1/run/remove-background:
    post:
      summary: 'Run: Remove Background (synchronous)'
      description: >-
        Cut the subject out of a video: the person isolated on a true alpha
        channel, ready to composite anywhere. SYNCHRONOUS: the call returns the
        finished cutout (~40-90s), no polling. The reflex call when an agent
        needs a background gone.
      operationId: run_remove_background
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                material:
                  type: string
                  description: A public https url, or an upload-ticket material handle.
                quality:
                  type: string
                  enum:
                    - best
                    - fast
                  description: >-
                    'best' (default) is the quality pick. 'fast' trades a little
                    edge fidelity for speed.
                outputFormat:
                  type: string
                  enum:
                    - webm
                    - mov
                    - mp4
                  description: >-
                    'webm' (default) = VP9 with true alpha. 'mov' = ProRes 4444
                    alpha. 'mp4' = green screen.
              required:
                - material
      responses:
        '200':
          description: >-
            The finished result — no polling. Typed refusals come back as 4xx
            with { errorCode }.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    $ref: '#/components/schemas/SyncRunResult'
components:
  schemas:
    SyncRunResult:
      type: object
      properties:
        status:
          type: string
          enum:
            - completed
        processedVideoUrl:
          type: string
          description: The finished output (e.g. VP9 alpha webm).
        canvasId:
          type: string
        editorPath:
          type: string
          description: Open the same result as an editable timeline.
        credits:
          type: number
        creditsCharged:
          type: boolean
        cached:
          type: boolean
          description: true when an identical prior run was returned free.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````