---
title: "Reel 9:16 desde un tema: guion, escenas, voz y subtítulos (persona a cámara: generate_ugc_video)"
method: POST
path: "/api/v1/generate_reel"
tags: ["General"]
---

# Reel 9:16 desde un tema: guion, escenas, voz y subtítulos (persona a cámara: generate_ugc_video)

`POST /api/v1/generate_reel`

## Request

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

Reel 9:16 desde un tema: guion, escenas, voz y subtítulos (persona a cámara: generate_ugc_video). Cotiza gratis; genera con cotizacion_id y acepto_costo_creditos:true si la persona aceptó. node_id: estado y cuadros.

## Request body

- object
  - `tema` string
  - `familia` 'gancho-broll' | 'ugc-subtitulos' | 'catalogo-animado' | 'antes-despues' | 'testimonio-resena'
  - `producto_id` string
  - `clips` string[]
  - `assets` string[]
  - `portada` object
    - `segundo` number
    - `texto` string
  - `antes` string
  - `despues` 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/d0c98499e173?raw)