media

genera imágenes y vídeos con ia, explora la biblioteca de medios del workspace y adjunta medios a posts. plataformas visuales como instagram, tiktok y pinterest requieren al menos un archivo multimedia.

generate_image

genera una imagen con ia (gemini) y la guarda automáticamente en la biblioteca de medios del workspace. no llames a upload_media después — la url devuelta ya está almacenada. usa attach_media con la url devuelta para añadirla a un post. soporta iteración mediante reference_image_url.

> crea una imagen hero para mi lanzamiento
  using antwork.generate_image

  [done] imagen generada
  [info] guardada en la biblioteca · url: https://...
parámetros
promptstringrequerido
descripción detallada de la imagen a generar
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene uno
reference_image_urlstringopcional
url de una imagen existente para usar como referencia (iteración)
aspect_ratiostringopcional
ratio deseado (ej. "1:1", "16:9", "9:16", "4:5"). por defecto: "1:1"
stylestringopcional
estilo visual (ej. "photorealistic", "flat design", "watercolor")

generate_video

genera un vídeo corto con veo 3.1 lite y lo guarda automáticamente en la biblioteca de medios del workspace. soporta clips de 4–8 segundos en 16:9 (horizontal) o 9:16 (vertical). la generación tarda ~30–120 segundos — la llamada bloquea hasta que el vídeo está listo.

> crea un vídeo vertical de 6 segundos para mi anuncio en reels
  using antwork.generate_video

  [done] vídeo generado
  [info] guardado en la biblioteca · modelo: veo-3.1-lite
parámetros
promptstringrequerido
descripción detallada del vídeo (cámara, movimiento, sujeto, escena, mood). veo recompensa prompts específicos.
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene uno
aspect_ratiostringopcional
"16:9" (horizontal, por defecto) o "9:16" (vertical — reels/shorts/tiktok)
duration_secondsnumberopcional
duración del clip en segundos (4–8). por defecto, el del modelo.
resolutionstringopcional
"720p" (por defecto) o "1080p"
generate_audiobooleanopcional
si generar pista de audio. por defecto true.
negative_promptstringopcional
cosas a evitar (ej. "blurry, low quality, watermarks")

list_media

lista los archivos multimedia en la biblioteca del workspace. devuelve imágenes y vídeos subidos con urls que se pueden adjuntar a posts.

> muéstrame mis imágenes subidas
  using antwork.list_media

  [done] 8 archivos multimedia encontrados
  [info] 6 imágenes, 2 vídeos
parámetros
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene uno
media_typestringopcional
filtrar por tipo: "image", "video", "pdf", o null para todos
limitnumberopcional
máximo de elementos (por defecto: 30, máx: 50)

get_media

obtiene un elemento multimedia por id. devuelve la url, nombre, tipo, tamaño y fecha de subida del medio.

> muéstrame los detalles de esa imagen
  using antwork.get_media

  [done] medio encontrado
  [info] tipo: image, tamaño: 2.4 MB
parámetros
media_idstringrequerido
el id del elemento multimedia

attach_media

adjunta medios (imágenes o vídeos) a un post existente. reemplaza cualquier medio existente en el post. requerido para plataformas visuales como instagram, tiktok y pinterest.

> adjunta nuestra última imagen de producto a ese post
  using antwork.attach_media

  [done] media adjuntado
  [info] 1 imagen añadida al post
parámetros
post_idstringrequerido
el id del post al que adjuntar
media_urlsstring[]requerido
lista de urls de medios (de list_media o firebase storage)

upload_media

sube una imagen a la biblioteca multimedia del workspace desde una url o datos base64. la imagen se almacena en firebase storage y se añade a la biblioteca.

> sube esta captura de producto a mi biblioteca multimedia
  using antwork.upload_media

  [done] imagen subida
  [info] url: https://storage.googleapis.com/...
parámetros
image_urlstringopcional
url pública de la imagen a subir. antwork la descargará y almacenará
image_base64stringopcional
datos de imagen codificados en base64 (alternativa a image_url)
mime_typestringopcional
tipo mime para subidas base64 (por defecto: "image/png")

delete_media

elimina un elemento multimedia de la biblioteca del workspace. borra el registro de firestore.

> elimina esa imagen antigua del banner
  using antwork.delete_media

  [done] medio eliminado
  [info] id: abc123
parámetros
media_idstringrequerido
el id del elemento multimedia a eliminar