v1Ressources/Posts/postGénérer une image pour une idée
Générer une image pour une idée
Nécessite l’accès Social et au client, une idée liée à un lieu et un générateur prêt. Réserve un crédit mensuel d’image avant génération et le libère si celle-ci échoue. Remplace replaceUrl si trouvé, sinon la couverture ; conserve les autres images. referenceIntents fournit du texte ; les images de référence ne sont pas prises en charge. Refuse le verrou de révision d’une autre personne. En cas de modification simultanée, renvoie status:not_attached, reason:idea_changed et l’image payée imageUrl sans écraser l’idée ; ne pas régénérer automatiquement. Ne publie pas.
post
ideas:write/api/v1/post-ideas/{id}/generate-visualParamètres de requête
idstringobligatoire
Corps de la requête
promptstringfacultatif
imageSizestring (landscape_16_9 | square_hd | square | portrait_16_9)facultatif
referenceIntentsarray of stringfacultatif
replaceUrlstringfacultatif
Réponse
dataobjectfacultatif
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.
409L’idée, les paramètres, les clients affectés ou la réservation de crédit ont changé ; relire l’état avant de réessayer.
422L’opération n’est pas valide pour cette idée ou ses destinations.
423Une autre personne examine ce calendrier importé.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503Le générateur ou l’opération est temporairement indisponible.
post/api/v1/post-ideas/{id}/generate-visual
Votre clé API
id *
Corps de la requête
{}Guides qui utilisent cette ressource
- 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.