v1Recursos/Posts/postGerar uma imagem para uma ideia
Gerar uma imagem para uma ideia
Requer acesso a Social e ao cliente, uma ideia de localização e um gerador pronto. Reserva um crédito mensal de imagem antes de gerar e o devolve se a geração falhar. Substitui replaceUrl quando encontrado, caso contrário a capa; preserva outras imagens. referenceIntents fornece texto; imagens de referência não são aceitas. Recusa bloqueio de revisão de outra pessoa. Se a ideia mudar durante a geração, retorna status:not_attached, reason:idea_changed e a imageUrl paga sem sobrescrever; não gere novamente de forma automática. Não publica.
post
ideas:write/api/v1/post-ideas/{id}/generate-visualParâmetros de consulta
idstringobrigatório
Corpo da solicitação
promptstringopcional
imageSizestring (landscape_16_9 | square_hd | square | portrait_16_9)opcional
referenceIntentsarray of stringopcional
replaceUrlstringopcional
Resposta
dataobjectopcional
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.
409A ideia, configurações, clientes afetados ou reserva de crédito mudaram; leia o estado atual antes de tentar novamente.
422A operação não é válida para esta ideia ou seus destinos.
423Outra pessoa está revisando este calendário importado.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
503O gerador ou a operação está temporariamente indisponível.
post/api/v1/post-ideas/{id}/generate-visual
Sua chave de API
id *
Corpo da solicitação
{}Guias que usam este recurso
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.
- How to Publish Google Business Profile Posts ProgrammaticallyPublish announcements, offers and events to Google Business Profile via API, schedule them, handle the missing-connection draft, and measure post performance.
- How to Retrieve Google Business Profile Analytics via APIPull Google Business Profile analytics through an API, portfolio-wide and per location, with views, calls, direction requests and a maps-versus-search split.
- Publish a Google Business Profile Post via APIPublish an announcement, offer or event to a location's connected platforms, and handle the draft returned when a platform is not connected.