Synupv1
Créer une clé
v1Ressources/Media/postModifier un asset par IA

Modifier un asset par IA

Régénère sur place l'image (ou le texte) d'un asset généré par Sydekick à partir d'une invite textuelle — la même action "Modifier avec l'IA" disponible dans l'onglet Données. Assets générés par Sydekick uniquement ; les téléversements et les médias synchronisés renvoient une erreur 409. Exécute une tâche en arrière-plan pouvant prendre une minute ou plus en cas de démarrage à froid.

post/api/v1/media/{id}/edit
media:write
Paramètres de requête
idstringobligatoire
L'asset généré à modifier, encodé en pourcentage (par ex. generated%3Aabc123).
Corps de la requête
promptstringobligatoire
Ce qu'il faut changer, en langage simple.
Réponse
dataobjectfacultatif
assetobjectfacultatif
keystringfacultatif
Identifiant composite du fichier, au format « <source>:<id> ».
sourcestringfacultatif
Origine de ce fichier (par ex. un envoi OS par rapport à une source importée).
idstringfacultatif
L'id du fichier au sein de sa source.
titlestringfacultatif
Le titre du fichier.
filenamestringfacultatif
Le nom de fichier d'origine du fichier.
mimestringfacultatif
Le type MIME du fichier.
kindstringfacultatif
Le type du fichier (photo ou vidéo).
sizeBytesnumberfacultatif
Taille du fichier en octets, ou null si inconnue.
urlstringfacultatif
URL prête à l'emploi pour les octets du fichier.
thumbnailUrlstringfacultatif
URL d'un aperçu miniature, ou null.
tagsarray of stringfacultatif
Étiquettes associées au fichier.
folderIdsarray of stringfacultatif
Dossiers de fichiers auxquels ce fichier appartient.
locationIdsarray of stringfacultatif
Tous les établissements auxquels ce fichier est associé.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
409Seuls les assets générés par Sydekick peuvent être modifiés par IA.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/media/{id}/edit
Votre clé API
id *
Corps de la requête*
{
  "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"
      ]
    }
  }
}