Saltar al contenido

Cast

Vídeos y pódcast hechos a partir de tus propios archivos, contactos y chats.

Abrir Cast
Comprobado con el panel el 20 de noviembre de 2026

Cast no tiene hoy métodos de API públicos. Todos los métodos que tiene llevan la marca private, así que ninguna clave de API puede llamar a uno, ni siquiera una clave con acceso total. Los métodos siguientes son los que llaman las pantallas de Cast, desde una sesión iniciada del panel. Se listan para que sepas qué hacen las pantallas, no como algo que llamar desde tu propio código.

Un video o un podcast se crea en el panel: desde la propia página de Cast, o arrastrando Cast sobre un contacto, un grupo de contactos, un chat de IA o una base de conocimiento para un video rápido. Desde fuera, solo el archivo terminado está al alcance:

  • Un archivo terminado es un archivo normal de tu Drive, en la carpeta definida en la configuración de Cast, así que funciona con él todo lo que Drive ofrece para archivos.

Cada método actúa en nombre del propietario del espacio de trabajo y responde code 1 cuando funciona. Un rechazo responde con un code negativo y explica el motivo en data. Todos los métodos aceptan un workspace_id opcional, para actuar en un espacio de trabajo de tu propiedad distinto del principal, y todos los métodos necesitan una sesión con autorización de usuario.

Las piezas

Un video o un podcast es una pieza: un documento con un id que se lee cst_ seguido de 16 caracteres hexadecimales. Sus escenas se leen sc_ seguido de 8 caracteres hexadecimales.

  • get_casts lista los videos y podcasts del espacio de trabajo, del más reciente al más antiguo. Junto con la lista responde el plan y sus límites, las creaciones de este mes, los valores predeterminados guardados, si este servidor puede crear y un precio típico en créditos para cada paso.
  • get_cast lee una pieza con su brief, elementos, storyboard y estado. Con frames en true, cada escena lleva además la imagen de su primer fotograma como URL de datos.
  • get_cast_frame lee la imagen de una escena (cast_id, scene_id) como URL de datos.
  • save_cast crea una pieza, o cambia una. Recibe cast_id (vacío crea una nueva), title (una línea, de hasta 120 caracteres), brief (tipo, propósito, descripción, idioma, voz, personaje principal, duración, tamaño, aspecto y opciones; las claves que no conoce se descartan. voice_language, un código de idioma del panel, es el idioma en el que se nombran las voces mientras language es auto: los presentadores de un podcast se llaman entre sí por esos nombres. El panel lo define con su propio idioma cuando crea una pieza), sources (hasta 20 elementos) y copy_of, que inicia un borrador nuevo a partir del brief, los elementos y el storyboard de otra pieza. Se rechaza mientras un guion o una creación esté trabajando en la pieza.
  • delete_cast elimina una pieza y sus fotogramas. El archivo creado a partir de ella permanece en tu Drive.

Un espacio de trabajo conserva hasta 200 piezas. Los elementos de una pieza son archivos y carpetas de Drive, contactos, grupos de contactos, chats de IA, bases de conocimiento, pilotos, enlaces y notas. Un conector se guarda pero todavía no se puede leer.

El guion y el storyboard

  • read_cast_reference mira un video de YouTube solo por su estilo y responde lo que un brief conserva de él como reference: su aspecto (colores, tipografía, esquinas, cámara, transiciones y cuánto duran, forma de los subtítulos), su ritmo (segundos por plano, cortes por minuto), su velocidad al hablar, notas breves sobre cómo está hecho, y lo que sugiere para el brief (tipo, propósito, formato, forma, duración). Recibe url. Se ejecuta como un trabajo (pasos: mirar el video, leer su estilo) y usa créditos de IA. Una pieza lo sigue cuando su brief contiene reference y style es reference: el guion se escribe a su ritmo y la construcción corta con sus transiciones. No se conserva nada del contenido del video.
  • write_cast_script escribe el guion a partir del brief y los elementos: escenas con el primer fotograma de cada una para un video, intervenciones para un podcast. Recibe cast_id y una instruction opcional de hasta 600 caracteres. Se ejecuta como un trabajo (pasos: leer tus elementos, escribir el guion, dibujar los primeros fotogramas), y los guiones y las imágenes usan créditos de IA.
  • edit_cast_storyboard aplica hasta 60 cambios en orden: confirm, unconfirm, confirm_all, delete, delete_all, move y set (las palabras de una escena, su subtítulo en pantalla, el titular, la cifra, las viñetas, la cita y el diseño de una tarjeta, y qué presentador dice una intervención). Un cambio mal formado rechaza toda la llamada. Responde con los fotogramas que dibujó de nuevo.
  • redo_cast_scene rehace una escena. Su mode es rewrite, picture (una imagen nueva, conservando las palabras), insert (una escena nueva en position, contando desde 0) o kind (cambia lo que muestra la escena: title, card, picture, stock, screenshot, presenter o podcast). instruction es de hasta 600 caracteres. Se ejecuta como un trabajo, y las imágenes y la escritura usan créditos de IA.

Crear y publicar

  • build_cast crea el archivo a partir del storyboard confirmado y lo guarda en el Drive. Una escena sin confirmar lo rechaza, salvo que confirm_all sea true. Se ejecuta como un trabajo (pasos: grabar la voz, preparar las imágenes, unir las escenas, mezclar el sonido, guardar en tu Drive). Las voces y las imágenes usan créditos de IA, y una creación que termina bien cuenta para el mes.
  • stop_cast_build detiene la creación que está en curso en una pieza.
  • publish_cast comparte una pieza creada. way es link, que activa el enlace (o lo desactiva, con off en true), o email, que envía el enlace a hasta 10 direcciones en to, con un message opcional de hasta 1000 caracteres. Cualquiera con el enlace puede ver o escuchar hasta que se elimine el archivo.
  • quick_cast crea un video infografía rápido sobre un contacto, un grupo de contactos, un chat de IA o una base de conocimiento: target_kind (contact, contact_group, chat o knowledge_base), target_id, un target_name opcional para el título y un language opcional que se usa cuando la configuración dice Auto. Usa los valores predeterminados guardados en la configuración. Se ejecuta como un trabajo (pasos: leer el elemento, escribir el guion, dibujar los fotogramas, crear el video).

Un servidor crea una pieza cada vez para todo el mundo. Un espacio de trabajo tiene como máximo dos puestos en esa cola, uno en curso y otro en espera, y un tercero se rechaza.

Configuración y planes

  • save_cast_settings guarda los valores predeterminados para las piezas nuevas y para los videos rápidos: language (auto o un código de idioma del panel), voice y gender, voice2 y gender2 para el segundo presentador, character, seconds, size (9:16, 1:1, 4:5 o 16:9), style, captions, music, quick_build y folder. Solo cambian las claves que envías.
  • get_cast_plans lee los planes con sus precios, funciones y derechos, el plan en el que está esta cuenta, si Cast está activado y las creaciones usadas este mes.
  • cast_set_plan activa Cast, cambia el plan (plan_id es cast_free, cast_starter, cast_growth o cast_business) o lo desactiva (un plan_id vacío, o deactivate en true). Desactivarlo conserva todos los videos y podcasts. Ambos métodos de plan aceptan un billing_workspace_id opcional, que solo importa cuando los planes de Cast se mantengan por espacio de trabajo.

Qué se rechaza

El panel dice cada uno de estos con palabras junto al control. En la respuesta del método son un code negativo con una frase en data:

  • Solo el propietario de un espacio de trabajo puede crear videos y podcasts en él. Un chat de un Assistant público no puede.
  • Cast está desactivado para la cuenta, o se ha usado el número de creaciones del mes del plan (se rechaza una creación, no un guion).
  • La duración, o el número de escenas, supera lo que permite el plan.
  • Se está trabajando en la pieza. Un guion o una creación está trabajando en ella, así que no se puede guardar ni editar hasta que termine o se detenga.
  • No hay suficientes créditos de IA para pagar un guion, una imagen o una voz.

¿Qué te parece esta guía?

Última actualización: 18 de noviembre de 2026