Synupv1
Crear clave
v1Recursos/Media/postEditar un asset con IA

Editar un asset con IA

Regenera la imagen (o el texto) de un asset generado por Sydekick en el mismo lugar a partir de un prompt de texto — la misma acción "Editar con IA" disponible en la pestaña Datos. Solo assets generados por Sydekick; las subidas y los medios sincronizados devuelven un 409. Ejecuta un trabajo en segundo plano que puede tardar un minuto o más en un arranque en frío.

post/api/v1/media/{id}/edit
media:write
Parámetros de consulta
idstringobligatorio
El asset generado a editar, codificado en porcentaje (p. ej. generated%3Aabc123).
Cuerpo de la solicitud
promptstringobligatorio
Qué cambiar, en lenguaje sencillo.
Respuesta
dataobjectopcional
assetobjectopcional
keystringopcional
Identificador compuesto del archivo, con el formato "<source>:<id>".
sourcestringopcional
Origen de este archivo (p. ej. una subida de OS frente a una fuente importada).
idstringopcional
El id del archivo dentro de su fuente.
titlestringopcional
El título del archivo.
filenamestringopcional
El nombre de archivo original del archivo.
mimestringopcional
El tipo MIME del archivo.
kindstringopcional
El tipo del archivo (foto o video).
sizeBytesnumberopcional
Tamaño del archivo en bytes, o null si se desconoce.
urlstringopcional
URL lista para usar con los bytes del archivo.
thumbnailUrlstringopcional
URL de una vista previa en miniatura, o null.
tagsarray of stringopcional
Etiquetas asociadas al archivo.
folderIdsarray of stringopcional
Carpetas de archivos a las que pertenece este archivo.
locationIdsarray of stringopcional
Todas las ubicaciones con las que está asociado este archivo.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
409Solo los assets generados por Sydekick se pueden editar con IA.
422A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/media/{id}/edit
Su clave de API
id *
Cuerpo de la solicitud*
{
  "data": {
    "asset": {
      "key": "upload:def456",
      "source": "upload",
      "id": "def456",
      "title": "Storefront photo (edited)",
      "filename": "storefront-edited.jpg",
      "mime": "image/jpeg",
      "kind": "image",
      "sizeBytes": 511204,
      "url": "https://cdn.synup.com/media/def456.jpg",
      "thumbnailUrl": "https://cdn.synup.com/media/def456-thumb.jpg",
      "tags": [
        "VIP"
      ],
      "folderIds": [
        "folder_1"
      ],
      "locationIds": [
        "loc_456"
      ]
    }
  }
}