Crear › Fotos junta todas las fotos del espacio en un lugar, sin importar dónde están guardadas. Cada foto tiene source: musa (subida a Musa), drive (sigue en el Google Drive de la persona), dropbox, onedrive o link (cualquier https). Musa no copia las de Drive ni las de Dropbox: guarda la referencia y una url lista para usar en diseños, videos y webs (las de Drive pasan por un enlace firmado de Musa). Son las mismas imágenes de «Tus imágenes» del editor de diseño.
Encontrar y traer fotos
1. photos_list({ workspaceId, source?, search?, tag? }) → todas las fotos con source, url, thumb, etiquetas y, si es una edición, de qué foto salió (from) y su receta.
2. photos_sources({ workspaceId }) → cuentas de Google Drive conectadas (psrc_…). Conectar una cuenta lo hace la persona en Crear › Fotos (Google pide su permiso); la IA no puede conectar cuentas.
3. Drive: photos_drive_list({ sourceId, folderId?, query? }) y photos_drive_import({ sourceId, fileIds }). Con el permiso básico de Google solo aparecen las fotos que la persona eligió en el selector de Google y las que Musa guardó en su carpeta «Musa».
4. Dropbox, Drive compartido, OneDrive o cualquier enlace: photos_import_link({ workspaceId, url, name?, tags? }).
5. Ordenar sin mover archivos: photos_update({ assetId, name?, tags?, addTags?, removeTags? }) (etiquetas por campaña, cliente o tema). photos_remove({ assetId }) la quita de Musa; si es de Drive, Dropbox o un enlace, el original sigue donde estaba.
Editar una foto suelta y guardarla
photos_save_copy({ fromAssetId, data, name?, recipe?, saveTo: "same" | "drive" | "musa" }) (data = la imagen en base64 o data URL).Las fotos también viven como capas de imagen dentro de un diseño. El revelado guarda una receta de ajustes por versión (nunca toca el original). La composición apila capas sobre la foto revelada (pintura, texto, otras imágenes) con modos de fusión y máscaras.
Una foto es un documento: fuente (una imagen por URL, o código que la dibuja) → retoque → geometría → revelado → filtros → capas. La persona lo edita con controles en el editor de fotos y tú con código: es lo mismo, en los dos sentidos, y todo es no destructivo.
1. Leer: photo_code_get({ assetId }) (foto de Crear › Fotos) o photo_code_get({ templateId, layerId }) (foto dentro de un diseño) → code (Musa Photo), doc (JSON), summary.
2. Cambiar partes: photo_edit({ ..., set: { "basic.exposure": 12, "wb.temp": -8, "fx.vignette": -20 }, addFilters: [{ kind: "blur", radius: 3 }], addLayers: [{ kind: "text", text: { s: "Hola", x: 0.1, y: 0.1, size: 0.08, color: "#ffffff" } }] }). También updateFilters/removeFilters/orderFilters, addMasks/updateMasks/removeMasks, updateLayers/removeLayers/orderLayers, reset, source.
3. Escribir todo: photo_code_apply({ ..., code }). Acepta código Musa Photo o de otro dialecto: CSS filter, canvas, filtro SVG, sharp, Jimp, Pillow / OpenCV (Python), ImageMagick → se convierten en ajustes y filtros editables. Si el código es un programa que dibuja o recorre píxeles (canvas, Three.js, p5, shader GLSL, SVG, HTML/CSS, Python con numpy o matplotlib), queda como fuente de la foto: corre aislado en el navegador y sigue editable.
4. Foto nueva desde código: photo_create_from_code({ workspaceId, code, name?, width?, height?, time? }).
5. Llevarla a un diseño: photo_to_design({ assetId }) (queda como capa que se sigue editando). A un video: desde la web, «Llevar esta foto a un video» (un código animado puede entrar como clip de código).
Geometría y extras: set: { "geo.persp": [[0.1,0.05],[0.92,0.1],[0.9,0.95],[0.05,0.9]] } corrige la perspectiva (como el recorte en perspectiva); set: { "geo.crop": { x: -0.1, y: -0.1, w: 1.2, h: 1.2 }, "geo.bg": "#ffffff" } agranda el lienzo con fondo (mesa de trabajo); addSlices crea cortes para exportar (en código: .grid(1, 3) para un carrusel de 3); samplers guarda muestras de color; una forma con smooth: true es una curva suave.
Reglas: coordenadas y tamaños van de 0 a 1 respecto de la foto; luz y color de -100 a 100. Un original nunca se toca: al escribirle a un original (assetId) nace su foto editada y te devuelvo el assetId nuevo — sigue con ese. El servidor no pinta: la imagen se vuelve a dibujar en el navegador (al instante si la foto está abierta; si no, la próxima vez que alguien la ve). Si la persona la tiene abierta, tus cambios se juntan con los suyos.
Ejemplo de código:
photo("https://…/foto.jpg")
.crop({ x: 0.1, y: 0, w: 0.8, h: 1 })
.light({ exposure: 12, contrast: 8, highlights: -20 })
.whiteBalance({ temp: 10 })
.detail({ clarity: 15, dehaze: 10 })
.mask("radial", { cx: 0.5, cy: 0.45, rx: 0.3, ry: 0.35 }, { exposure: 25 })
.filter("duotone", { dark: "#1b1464", light: "#ffd166", amount: 60 })
.text("Oferta", { x: 0.08, y: 0.8, size: 0.1, color: "#ffffff", font: "Anton" })
Retocar una foto
1. photo_list_assets({ templateId }) → fotos del diseño.
2. photo_open_session({ templateId, layerId }) → receta actual y versiones.
3. Rápido: photo_apply_preset({ templateId, layerId, presetId }) (8 presets curados).
4. Fino: photo_update_operation (cambia algunos valores de una operación: básico, balance de blancos, color, HSL, curvas, detalle…) o photo_apply_operation (la reemplaza entera). photo_remove_operation la deja neutra.
5. Ajustes locales: photo_create_mask (radial, lineal o pincel) y photo_update_mask.
6. Guarda una versión con photo_create_variant({ ..., recipe, label }). photo_compare_versions y photo_restore_version para comparar o volver.
Componer
1. photo_compose_get → pila de capas.
2. photo_compose_add_layer (pintura, imagen, texto), photo_compose_update_layer (fusión, opacidad, posición), photo_compose_set_layer_mask.
3. photo_compose_reorder_layers, photo_compose_duplicate_layer, photo_compose_delete_layer. photo_compose_clear vacía todo (pide confirm: true; solo si lo piden).
Quitar fondo o recortar sujeto
remove_background({ assetId | url, workspaceId }); si devuelve un trabajo, consulta segment_status.segment_click + segment_status.musa-vectores.Generar o editar con IA
ai_generate_image({ prompt, imageBase64?, aspectRatio? }): genera o edita (Nano Banana). Pasa la imagen original para editarla.separate_image_layers({ imageUrl }) → separate_image_layers_check hasta que termine: separa una imagen en capas (fondo, sujeto, textos).musa-video (generate_image_video).Preparar para web
optimize_image: WebP con calidad y ancho máximo. upload_image para subir el resultado.Fotos del espacio (Musa, Drive, Dropbox, enlaces)
photos_list, photos_sources, photos_import_link, photos_update, photos_remove.photos_drive_list, photos_drive_import, photos_save_copy.La foto como código
photo_code_get, photo_code_apply, photo_edit.photo_create_from_code, photo_to_design.Revelado
photo_list_assets, photo_open_session, photo_create_variant.photo_apply_operation, photo_update_operation, photo_remove_operation, photo_apply_preset.photo_create_mask, photo_update_mask.photo_compare_versions, photo_restore_version.Composición
photo_compose_get, photo_compose_add_layer, photo_compose_update_layer, photo_compose_delete_layer.photo_compose_reorder_layers, photo_compose_duplicate_layer, photo_compose_set_layer_mask, photo_compose_clear.Recorte e IA
remove_background, segment_click, segment_status.ai_generate_image, separate_image_layers, separate_image_layers_check.optimize_image, upload_image.url tal cual (no la descargues ni la vuelvas a subir).render_frame_png (skill musa-diseno).