v1Recursos/Posts/postGenerar una imagen para una idea
Generar una imagen para una idea
Requiere acceso a Social y al cliente, una idea de ubicación y un generador disponible. Reserva un crédito mensual de imagen antes de generar y lo devuelve si la generación falla. Reemplaza replaceUrl si existe o la portada; conserva otras imágenes. referenceIntents aporta texto; no admite imágenes de referencia. Rechaza bloqueos de revisión de otra persona. Si la idea cambia durante la generación, devuelve status:not_attached, reason:idea_changed y la imageUrl pagada sin sobrescribir; no vuelva a generar automáticamente. No publica.
post
ideas:write/api/v1/post-ideas/{id}/generate-visualParámetros de consulta
idstringobligatorio
Cuerpo de la solicitud
promptstringopcional
imageSizestring (landscape_16_9 | square_hd | square | portrait_16_9)opcional
referenceIntentsarray of stringopcional
replaceUrlstringopcional
Respuesta
dataobjectopcional
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.
409La idea, configuración, clientes afectados o reserva de crédito cambiaron; lea el estado antes de reintentar.
422La operación no es válida para esta idea o sus destinos.
423Otra persona está revisando este calendario importado.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
503El generador o la operación no están disponibles temporalmente.
post/api/v1/post-ideas/{id}/generate-visual
Su clave de API
id *
Cuerpo de la solicitud
{}Guías que usan 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.