Synupv1
Criar chave
v1Recursos/Media/postEditar um asset com IA

Editar um asset com IA

Regenera a imagem (ou o texto) de um asset gerado pelo Sydekick no mesmo local a partir de um prompt de texto — a mesma ação "Editar com IA" disponível na aba Dados. Somente assets gerados pelo Sydekick; uploads e mídia sincronizada retornam um 409. Executa um trabalho em segundo plano que pode levar um minuto ou mais em uma inicialização a frio.

post/api/v1/media/{id}/edit
media:write
Parâmetros de consulta
idstringobrigatório
O asset gerado a editar, codificado em porcentagem (ex.: generated%3Aabc123).
Corpo da solicitação
promptstringobrigatório
O que alterar, em linguagem simples.
Resposta
dataobjectopcional
assetobjectopcional
keystringopcional
Identificador composto do arquivo, no formato "<source>:<id>".
sourcestringopcional
Origem deste arquivo (ex.: um envio do OS em vez de uma fonte importada).
idstringopcional
O id do arquivo dentro de sua fonte.
titlestringopcional
O título do arquivo.
filenamestringopcional
O nome de arquivo original do arquivo.
mimestringopcional
O tipo MIME do arquivo.
kindstringopcional
O tipo do arquivo (foto ou vídeo).
sizeBytesnumberopcional
Tamanho do arquivo em bytes, ou null se desconhecido.
urlstringopcional
URL pronta para uso com os bytes do arquivo.
thumbnailUrlstringopcional
URL de uma miniatura de pré-visualização, ou null.
tagsarray of stringopcional
Tags associadas ao arquivo.
folderIdsarray of stringopcional
Pastas de arquivos às quais este arquivo pertence.
locationIdsarray of stringopcional
Todos os locais associados a este arquivo.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
409Somente assets gerados pelo Sydekick podem ser editados com IA.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/media/{id}/edit
Sua chave de API
id *
Corpo da solicitação*
{
  "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"
      ]
    }
  }
}