---
title: "Filmsquare para Blender"
description: "Trae los elementos y la imagen fija de un plano a Blender para la marcación 3D, y envía de vuelta una imagen fija o un playblast como nueva versión del plano."
url: https://www.filmsquare.ai/docs/es/plugins/blender/
lang: es
section: plugins
updated: 2026-11-09
---

# Filmsquare para Blender

El add-on de Filmsquare para Blender 4.2 y posteriores trae un plano a tu escena: el elenco, las locaciones y los objetos de utilería que usa, y su imagen fija. Cuando la marcación está lista, envía de vuelta una imagen fija o un playblast al mismo plano como nueva versión. El trabajo aparece bajo **Storyboard → 3D** de la producción.

El add-on está en beta. Es gratuito y tiene licencia GPL-3.0-or-later.

## Instalación

1. Descarga `blender.zip` desde la página Plugins.
2. En Blender, abre **Edit → Preferences → Get Extensions**.
3. Abre el menú arriba a la derecha, elige **Install from Disk** y luego elige el zip.
4. En **Preferences → System**, activa **Allow Online Access**. Sin eso, el add-on no se conecta.

## Inicia sesión con una clave personal

El add-on funciona en tu nombre, con tu rol, en un solo espacio de trabajo. Usa una clave personal, del mismo tipo que usas para Claude Code.

1. En Filmsquare, abre **Settings → Claude** y elige **Use a personal key instead**.
2. Dale un **Name of the key** (por ejemplo "Blender en mi estación de trabajo") y elige **Create a personal key**.
3. Copia la clave. Empieza por `fsk_` y se muestra una sola vez.
4. En Blender, abre **Edit → Preferences → Add-ons**, despliega **Filmsquare** y pega la clave en **Key**.
5. Elige **Test**. El add-on muestra el espacio de trabajo y tu rol.

La clave se guarda en tus preferencias de Blender, solo en esta computadora. Cualquiera con la clave puede trabajar como tú en este espacio de trabajo: revócala en **Settings → Claude** si se filtra.

> [!NOTE]
> Cualquier rol puede traer un plano. Devolver trabajo requiere el rol maker o superior.

## Elige un plano

Abre la barra lateral en el viewport 3D (elige `N`) y elige la pestaña **Filmsquare**. Elige, de arriba abajo:

1. **Production**
2. **Episode**
3. **Scene**. Una producción sin escenas con nombre tiene una escena, **All shots**.
4. **Shot**

El botón de actualizar recarga la lista de producciones.

## Traer los elementos y la imagen fija

Bajo **Import**, elige cómo llegan las referencias y luego **Import elements and still**:

| Opción | Qué obtienes |
| --- | --- |
| **Empties** | Image empties: ligeros, no se renderizan. |
| **Planes** | Image planes con un material: se renderizan. |

El add-on crea una colección `Filmsquare` con una colección por plano, que contiene **Cast**, **Locations**, **Props** y **Stills**. Por cada elemento toma la versión que usa el plano (la versión fijada, o la actual) y las dos mejores referencias de esa versión: primero las canónicas, y para el elenco, la frontal o de cuerpo entero; para las locaciones, la general. Los elementos de estilo se dejan fuera.

La imagen fija del plano (el keyframe elegido, o el más reciente) también pasa a ser el fondo de la cámara de la escena. Con **Use shot lens** activado, la cámara toma la distancia focal del plano. Volver a importar solo añade lo nuevo.

## Devolver una imagen fija

1. Encuadra el plano con la cámara de la escena.
2. En **Send**, elige **Still from**: **Render** (el motor de render) o **Viewport** (rápido, una imagen del viewport a través de la cámara de la escena).
3. Opcionalmente describe el movimiento de cámara en **Move**, por ejemplo "push in lento".
4. Elige **Send still**.

El encuadre llega al plano bajo **Storyboard → 3D**, con la distancia focal de la cámara y su altura sobre el suelo (en metros). Cada imagen fija que envías es una nueva versión del encuadre de marcación del plano; cuenta la más reciente. En Filmsquare, a partir de él se puede hacer una toma, con el encuadre como referencia de estructura.

La primera vez que envías trabajo, Filmsquare te pide una vez que declares que tienes los derechos de tus archivos. El add-on muestra entonces esa declaración en **Send** con **Confirm**. Elige **Confirm** y vuelve a enviar.

## Devolver un playblast

Elige **Send playblast**. El add-on renderiza la animación del viewport en el rango de cuadros de la escena a un MP4 y lo añade al plano como clip 3D bajo **Storyboard → 3D**. Enviar otra vez desde el mismo plano crea una nueva versión de ese clip. Los archivos de más de 64 MB se suben por partes, así que un playblast largo también funciona.

## Qué se queda en Filmsquare

El add-on solo llama a la [API](https://www.filmsquare.ai/docs/es/api/overview/) pública con tu clave. Las versiones de los elementos, las tomas elegidas, los vistos buenos y los costos se quedan en Filmsquare; el add-on los lee y nunca los cambia. No crea tomas y no gasta créditos.
