Orshot : automatisation de la génération d'images, PDF et vidéos à partir de modèles et publication sur les réseaux sociaux

Orshot est une API de génération automatisée d'images, PDF et vidéos à partir de modèles. Créez un modèle une fois dans le studio Orshot (ou importez-le depuis Canva ou Figma), puis générez-le avec de nouveaux textes, images et vidéos à chaque appel, et publiez le résultat sur des comptes sociaux connectés dans la même requête. Le rendu est déterministe : le même modèle avec les mêmes données produit toujours le même résultat.

Documentation : https://orshot.com/docs (ajoutez .md à toute URL de doc pour obtenir du markdown)
Serveur MCP hébergé : https://mcp.orshot.com/mcp (100+ outils orshot_*)
Base REST : https://api.orshot.com/v1
Plan gratuit : 100 crédits par mois, sans carte de crédit.

Connectez-vous d'abord (MCP, pas de clé à coller)

Le serveur MCP hébergé est le moyen le plus rapide et le seul qui renvoie des aperçus intégrés, des cartes visuelles et des vérifications de design. Ajoutez-le, connectez-vous avec le compte Orshot de l'utilisateur dans le navigateur, et tous les outils ci-dessous fonctionnent.

openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth
openclaw mcp login orshot

Pas encore de compte Orshot ? La page de connexion propose l'inscription ; le plan gratuit démarre avec 100 crédits par mois. Claude Code : claude mcp add --transport http orshot https://mcp.orshot.com/mcp. Cursor, Windsurf, VS Code, Codex et ChatGPT prennent la même URL comme serveur MCP distant.

Confirmez avec orshot_get_account. Il renvoie le profil, les espaces de travail et les crédits. Si la réponse indique que l'abonnement est inactif ou qu'une limite du plan est atteinte, il s'agit d'un état de facturation, pas d'une erreur d'authentification : dirigez l'utilisateur vers la page de facturation de son espace de travail à https://orshot.com/pricing et cessez de réessayer.

Solution de repli sans navigateur : REST avec une clé API. Uniquement lorsque l'agent ne peut pas exécuter MCP (tâche cron, script côté serveur, n8n).

export ORSHOT_API_KEY=...   # Paramètres de l'espace de travail > Clés API
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"

Ne continuez pas tant que l'une des deux méthodes ne fonctionne pas.

Ce que vous pouvez faire avec

Chaque ligne indique d'abord l'outil MCP puis la route REST.

Générer n'importe quel modèle avec vos données : OG images, visuels publicitaires, certificats, factures, carrousels, reels. orshot_render_template ou POST /v1/studio/render.
Créer et affiner des modèles studio à partir d'un brief, avec aperçus intégrés et vérifications de design. orshot_create_template_design, orshot_update_template_design, orshot_patch_template_elements (lisez d'abord orshot://template-design-spec ; la compétence orshot-social-media-content contient les règles d'art).
Générer de la vraie vidéo : animations et transitions par élément, bandes sonores depuis la charte graphique, prévisualisations de mouvement gratuites avant un rendu payant. Même outil de rendu avec format: "mp4".
Commencer avec des modèles prêts à l'emploi : captures d'écran de tweets, captures d'écran de sites web, graphiques à barres et de comparaison, captures d'écran d'app stores, maquettes de téléphone, suppression d'arrière-plan. orshot_render_library_template ou POST /v1/generate/:renderType.
Redimensionner un design pour tous les formats sociaux en un seul appel (Smart Resize). Utilisez size et extraSizes sur le rendu.
Générer par lots des variantes personnalisées, comme des certificats pour une liste de noms. orshot_batch_render_template.
Rester cohérent avec la marque : couleurs, polices, images, vidéos et audio depuis la charte graphique. orshot_get_brand_kit, orshot_import_brand_website.
Organiser : dossiers, partage de modèles, basculement entre les espaces de travail clients. orshot_list_template_folders, orshot_set_active_workspace.
Générer des URLs dynamiques signées pour les OG images et les embeds. orshot_create_dynamic_url ou POST /v1/signed-url/create.
Rédiger, planifier et publier des posts sur les réseaux sociaux, connaître le meilleur moment pour poster à partir des données d'engagement de l'utilisateur, consulter les analyses de portée et d'engagement. orshot_publish_social_post, orshot_get_best_time_to_post, orshot_get_social_analytics. La compétence orshot-social-media-scheduler contient la boucle complète.
Créer et exécuter des workflows d'automatisation qui produisent du contenu en continu selon un planning. orshot_create_workflow, orshot_run_workflow.

Exemples de requêtes qui correspondent directement à ces outils :

« Générez le modèle de lancement en OG image avec le titre 'On a livré' »
« Créez un modèle de post Instagram avec un titre, un sous-titre et une image produit »
« Redimensionnez mon design de lancement pour Instagram story, carré et OG en un seul appel »
« Générez des certificats pour cette liste de 40 noms au format PDF »
« Capturez ce tweet » / « Capturez orshot.com en image » / « Créez un graphique à barres à partir de ces chiffres »
« Publiez ce rendu sur Instagram au meilleur moment et montrez-moi les performances des posts de la semaine dernière »

Workflow principal

Connectez-vous (ci-dessus).
Trouvez le modèle. orshot_list_studio_templates (recherche par nom et tags) ou GET /v1/studio/templates/all?page=1&limit=10. Pas encore de modèle ? Utilisez les 2 000+ modèles de la bibliothèque (orshot_list_library_templates) ou créez-en un avec orshot_create_template_design.
Lisez ses paramètres. orshot_get_studio_template_modifications ou GET /v1/studio/templates/:id. Les modifications sont indexées par parameterId, jamais par nom de calque. Ne devinez jamais les clés.
Générez. orshot_render_template avec modifications, ou POST /v1/studio/render avec response: { type: "url", format: "png" }.
Livrez ou publiez. Montrez l'URL de sortie à l'utilisateur. Ajoutez publish pour publier sur les réseaux sociaux dans le même appel.
Automatisez. Intégrez l'appel dans n8n, Make, Zapier ou cron que l'utilisateur utilise déjà, ou créez un Workflow Orshot.
Vérifiez. orshot_list_workspace_logs ou GET /v1/workspace/logs affiche le rendu et sa source. Montrez la sortie avant de déclarer la tâche terminée.

Règles de sécurité pour les agents

Confirmez avant toute action qui sort de l'espace de travail. La publication d'un post social, l'exécution d'un workflow (qui consomme des crédits et peut livrer ou publier) et la suppression d'un modèle, d'un workflow ou d'un asset de marque nécessitent une approbation explicite. Dites ce qui sera publié, où et quand.
Par défaut, les posts sociaux sont des brouillons. « Prépare », « brouillon », « laisse-moi d'abord jeter un œil » signifient status: "draft". Un brouillon n'est visible par personne tant qu'il n'est pas publié.
Montrez le coût avant un travail en masse. Les rendus consomment des crédits, les modifications .prompt consomment des crédits IA, et chaque compte social connecté est un module payant supplémentaire. Prévenez avant une boucle de centaines de rendus.
Ne collez jamais la clé API dans le chat, les fichiers ou les URLs. Lisez-la depuis l'environnement. Privilégiez MCP, qui n'a pas de clé du tout.
Ne supprimez rien pour « faire le ménage » de votre propre chef.

Pièges courants (à lire avant de générer)

Les modifications sont indexées par parameterId, pas par nom de calque. Si une valeur est ignorée, la clé est erronée. Récupérez le modèle au lieu de deviner.
Les modèles multipages nécessitent un préfixe pageN@. "page1@title", "page2@title". Un "title" nu ne touche que la page 1.
Le templateId studio est un entier ; le templateId utilitaire est une chaîne (/v1/generate/:renderType prend un slug comme "website-screenshot").
La sortie vidéo ne nécessite pas de calques vidéo. format: "mp4", "webm" ou "gif" génère n'importe quel modèle. Les rendus vidéo longs doivent utiliser response.mode: "async" et interroger orshot_get_render_job ou GET /v1/studio/render-jobs/:id, sinon le client expire.
Les URLs d'image et de vidéo dans les modifications doivent être publiques. Le moteur de rendu les récupère côté serveur ; localhost, les URLs signées expirées et les URLs protégées par authentification échouent.
Les surcharges de style utilisent la notation par point sur le parameterId : "title.fontSize": "48px".
La forme de la réponse diffère selon le nombre de pages. Une page : data est un objet (data.content). Plusieurs pages : data est un tableau de { page, content }.
base64 et binary ne se combinent pas. binary diffuse un seul fichier.
Les crédits et les crédits IA sont distincts. Les modifications .prompt dépensent des crédits IA en plus.
En cas de 429, reculez en utilisant Retry-After.
Les PDF ne peuvent pas être publiés sur les réseaux sociaux. Les images ne peuvent pas aller sur TikTok ou YouTube (vidéo uniquement). Les vidéos ne peuvent pas aller sur Google Business.
Les identifiants de comptes sociaux sont des nombres. Deux comptes sur la même plateforme ont des identifiants différents. Publiez toujours par identifiant, jamais par nom de plateforme.
La publication sociale est un module payant supplémentaire. Les espaces de travail du plan gratuit ne peuvent pas connecter de comptes. La publication en elle-même ne consomme pas de crédits supplémentaires.

Éléments essentiels du rendu

Référence complète des champs : references/render-configuration.md et references/api-reference.md.

await fetch("https://api.orshot.com/v1/studio/render", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
  body: JSON.stringify({
    templateId: 123,
    modifications: {
      title: "Jour de lancement",             // texte
      hero_image: "https://.../a.png", // URL d'image
      "title.fontSize": "56px",        // surcharge de style
      "page2@title": "Diapositive deux",      // multipage
    },
    response: { type: "url", format: "png", size: "instagram-story",
                extraSizes: ["1080x1080", "1200x630"] },
  }),
});

Le même objet est l'entrée de orshot_render_template sur MCP.

format : png, jpg, webp, pdf, mp4, webm, gif.
size génère le design dans un autre format prédéfini ou LARGEURxHAUTEUR ; extraSizes ajoute des copies supplémentaires en un seul appel (Smart Resize). Formats prédéfinis : orshot://formats.
response.mode: "async" renvoie un job ; interrogez-le ou passez webhook_url. Utilisez-le pour la vidéo.
Plusieurs variantes à la fois : orshot_batch_render_template, ou bouclez l'appel de rendu via REST.
URLs signées : POST /v1/signed-url/create pour une URL de rendu que vous pouvez intégrer sans exposer la clé.

SDK pour une utilisation sans navigateur : npm install [email protected], pip install orshot==0.2.0, composer require rishimohan/orshot:0.2.0, gem install orshot -v 0.2.0.

import { Orshot } from "orshot";
const orshot = new Orshot(apiKey); // lisez depuis votre environnement
const res = await orshot.renderFromTemplate({
  templateId: "open-graph-image-1",
  modifications: { title: "Bonjour tout le monde" },
  responseType: "url",
  responseFormat: "png",
});

Publication sociale (version courte)

Orshot publie des rendus sur 13+ plateformes : X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Telegram, Snapchat, Google Business. La compétence orshot-social-media-scheduler gère la planification, les brouillons, les analyses et le meilleur moment ; voici les bases.

Comptes. orshot_list_social_accounts ou GET /v1/social/accounts?include_health=true. Les comptes sont connectés par un humain dans le tableau de bord (Espace de travail > Réseaux sociaux > Comptes) ; l'API ne peut pas en connecter un. Une liste vide signifie d'y envoyer l'utilisateur.
Générer et publier en un seul appel. Ajoutez publish au rendu :

publish: {
  accounts: [1, 3],
  content: "Légende, 5000 caractères max",
  status: "draft",                       // "published" (par défaut) | "draft" | "scheduled"
  // scheduled_for: "2026-11-01T14:00:00Z", timezone: "America/New_York",
  platformOptions: { "3": { firstComment: "https://orshot.com" } },
  tiktokSettings: { autoAddMusic: true }, // Carrousels photo TikTok
}

Les modèles multipages sont automatiquement publiés sous forme de carrousel. La réponse contient publish[] avec status, url et error par compte. Un échec de publication ne bloque jamais le rendu.

Publier une URL média existante. orshot_publish_social_post ou POST /v1/social/publish avec media_urls.
Posts en attente. orshot_list_social_posts, orshot_get_social_post (carte visuelle), orshot_update_social_post, orshot_publish_social_draft, orshot_discard_social_post. REST : GET|PATCH|DELETE /v1/social/posts/:id, POST /v1/social/posts/:id/publish.
Analytiques et meilleur moment. orshot_get_social_analytics, orshot_get_social_analytics_daily, orshot_get_social_followers, orshot_get_best_time_to_post. REST : GET /v1/social/analytics, /daily, /accounts, /insights.

Recettes courantes

OG image à chaque déploiement

response: { type: "url", format: "png", size: "og-image" }
// <meta property="og:image" content={data.content} />

En masse à partir d'un CSV (certificats, factures, badges) : orshot_batch_render_template avec un ensemble de modifications par ligne et format: "pdf", ou bouclez POST /v1/studio/render.

Graphique social hebdomadaire, posté en brouillon pour révision : générez avec publish.status: "draft", puis orshot_publish_social_draft après l'approbation de l'utilisateur.

Un design, tous les formats : extraSizes: ["1080x1920", "1080x1080", "1200x630"].

Carrousel TikTok, Instagram ou LinkedIn : voir la compétence orshot-carousel.

Pipeline récurrent : references/recurring-automation.md. Vérifiez les logs de l'espace de travail pour la source que l'utilisateur utilise déjà (n8n, Make, Zapier, SDK) et ajoutez-vous à celle-ci ; proposez les Workflows Orshot uniquement s'ils n'utilisent encore rien.

Fichiers de référence

Lisez-les à la demande ; ils ne sont pas chargés par défaut.

Fichier	Quand
`references/api-reference.md`	chaque endpoint REST : rendu, modèles, URLs signées, assets de marque, URLs dynamiques, dossiers, workflows
`references/render-configuration.md`	types de modification, options vidéo, jobs asynchrones, animations, audio, Smart Resize, types de réponse, crédits
`references/template-design-spec.md`	schéma des éléments pour créer ou modifier des modèles via l'API
`references/recurring-automation.md`	playbook n8n, Make, Zapier, Pipedream, cron et Workflows Orshot
`references/integrations-and-errors.md`	liste des intégrations, codes d'erreur, bonnes pratiques
`references/oauth-developer-apps.md`	construction d'une application tierce sur Orshot avec OAuth
`references/embed.md`	embed de l'éditeur en marque blanche (iframe, React, Vue)
`references/migration.md`	migration depuis Bannerbear, Placid, Templated, Creatomate ou similaire

Toute page de documentation est disponible en markdown : https://orshot.com/docs/<chemin>.md. Le serveur MCP sert également orshot://template-design-spec et orshot://formats.

Référence rapide

# connexion
openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth && openclaw mcp login orshot
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"   # Vérification REST

# modèles
GET  /v1/studio/templates/all?page=1&limit=2

…

Orshot : automatisation de la génération d'images, PDF et vidéo…

Qu'est-ce que Orshot : automatisation de la génération d'images, PDF et vidéo… ?

Demander à votre IA préférée

Documentation