Cast
Vídeos y pódcast hechos a partir de tus propios archivos, contactos y chats.
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_castslista 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_castlee una pieza con su brief, elementos, storyboard y estado. Conframesentrue, cada escena lleva además la imagen de su primer fotograma como URL de datos.get_cast_framelee la imagen de una escena (cast_id,scene_id) como URL de datos.save_castcrea una pieza, o cambia una. Recibecast_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 mientraslanguageesauto: 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) ycopy_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_castelimina 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_referencemira un video de YouTube solo por su estilo y responde lo que un brief conserva de él comoreference: 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). Recibeurl. 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 contienereferenceystyleesreference: 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_scriptescribe el guion a partir del brief y los elementos: escenas con el primer fotograma de cada una para un video, intervenciones para un podcast. Recibecast_idy unainstructionopcional 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_storyboardaplica hasta 60 cambios en orden:confirm,unconfirm,confirm_all,delete,delete_all,moveyset(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_scenerehace una escena. Sumodeesrewrite,picture(una imagen nueva, conservando las palabras),insert(una escena nueva enposition, contando desde 0) okind(cambia lo que muestra la escena:title,card,picture,stock,screenshot,presenteropodcast).instructiones 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_castcrea el archivo a partir del storyboard confirmado y lo guarda en el Drive. Una escena sin confirmar lo rechaza, salvo queconfirm_allseatrue. 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_builddetiene la creación que está en curso en una pieza.publish_castcomparte una pieza creada.wayeslink, que activa el enlace (o lo desactiva, conoffentrue), oemail, que envía el enlace a hasta 10 direcciones ento, con unmessageopcional de hasta 1000 caracteres. Cualquiera con el enlace puede ver o escuchar hasta que se elimine el archivo.quick_castcrea 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,chatoknowledge_base),target_id, untarget_nameopcional para el título y unlanguageopcional 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_settingsguarda los valores predeterminados para las piezas nuevas y para los videos rápidos:language(autoo un código de idioma del panel),voiceygender,voice2ygender2para el segundo presentador,character,seconds,size(9:16,1:1,4:5o16:9),style,captions,music,quick_buildyfolder. Solo cambian las claves que envías.get_cast_planslee 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_planactiva Cast, cambia el plan (plan_idescast_free,cast_starter,cast_growthocast_business) o lo desactiva (unplan_idvacío, odeactivateentrue). Desactivarlo conserva todos los videos y podcasts. Ambos métodos de plan aceptan unbilling_workspace_idopcional, 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.