---
title: "Grabación de pantalla (pieza_id de upload_creative) → Reel 9:16: recorte, tramos (sin velocidad se quitan), zooms (zona centro, arriba-derecha… o {x,y,ancho,alto}), subtítulos, gancho, cierre con cta"
method: POST
path: "/api/v1/edit_screen_recording"
tags: ["General"]
---

# Grabación de pantalla (pieza_id de upload_creative) → Reel 9:16: recorte, tramos (sin velocidad se quitan), zooms (zona centro, arriba-derecha… o {x,y,ancho,alto}), subtítulos, gancho, cierre con cta

`POST /api/v1/edit_screen_recording`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/edit_screen_recording`
- Auth: HTTP bearer

Grabación de pantalla (pieza_id de upload_creative) → Reel 9:16: recorte, tramos (sin velocidad se quitan), zooms (zona centro, arriba-derecha… o {x,y,ancho,alto}), subtítulos, gancho, cierre con cta. Segundos de la grabación. Cotiza como generate_reel.

## Request body

- object
  - `pieza_id` string
  - `inicio_s` number
  - `fin_s` number
  - `velocidad` number
  - `tramos` object[]
    - `desde_s` number, required
    - `hasta_s` number, required
    - `velocidad` number
  - `zooms` object[]
    - `desde_s` DesdeS, required (unresolved $ref)
    - `hasta_s` HastaS, required (unresolved $ref)
    - `zona` union, required
      - string
      - object
        - `x` number, required
        - `y` number, required
        - `ancho` number, required
        - `alto` number, required
  - `subtitulos` boolean
  - `textos` object[]
    - `desde_s` DesdeS, required (unresolved $ref)
    - `hasta_s` HastaS, required (unresolved $ref)
    - `texto` string, required
  - `gancho` string
  - `cta` string
  - `node_id` string, uuid
  - `cotizacion_id` string
  - `acepto_costo_creditos` boolean

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pymaia/apis/pymaia-api.md) · [All operations](https://skmtc.dev/pymaia/apis/pymaia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pymaia/apis/pymaia-api/revisions/b8e21a01970f?raw)