DÉVELOPPEURS · API ET MCP

Un appel d'API, un visuel.

Le même modèle sert l'éditeur, le tableur et le code : variables nommées, formats par nom, un crédit par fichier rendu. Une clé de test génère sans consommer.

Créer une clé Lire la documentation

curl -X POST https://suwar.app/api/v1/render \  -H "Authorization: Bearer $SUWAR_KEY" \  -H "Content-Type: application/json" \  -d '{ "template_id": "grand-titre-photo", "format": "post",        "variables": { "sujet": "pubs", "verbe": "vendent",                       "accroche": "dès lundi" } }'

200 OK{ "id": "rnd_8f2kq1", "status": "completed", "format": "post",  "width": 1080, "height": 1350, "credits": 1,  "url": "https://suwar.app/uploads/renders/rnd_8f2kq1.png" }

Des pubsqui vendent,dès lundi →

const res = await fetch('https://suwar.app/api/v1/render', {  method: 'POST',  headers: { Authorization: `Bearer ${process.env.SUWAR_KEY}` },  body: JSON.stringify({ template_id: 'grand-titre-photo', format: 'post',    variables: { sujet: 'pubs', verbe: 'vendent', accroche: 'dès lundi' } }),});

200 OK{ "id": "rnd_8f2kq1", "status": "completed", "format": "post",  "width": 1080, "height": 1350, "credits": 1,  "url": "https://suwar.app/uploads/renders/rnd_8f2kq1.png" }

Des pubsqui vendent,dès lundi →

import os, requestsres = requests.post('https://suwar.app/api/v1/render',    headers={'Authorization': f"Bearer {os.environ['SUWAR_KEY']}"},    json={'template_id': 'grand-titre-photo', 'format': 'post',          'variables': {'sujet': 'pubs', 'verbe': 'vendent',                        'accroche': 'dès lundi'}})

200 OK{ "id": "rnd_8f2kq1", "status": "completed", "format": "post",  "width": 1080, "height": 1350, "credits": 1,  "url": "https://suwar.app/uploads/renders/rnd_8f2kq1.png" }

Des pubsqui vendent,dès lundi →

Décline « Grand titre sur photo » pour les 4 lignes de Campagne d'automne, en Post et en Story.

list_templatesProjet 1 · 6 modèles

render_dataset_batchCampagne d'automne · 4 lignes × 2 formats

wait_for_render8 visuels prêts

Lignes 1 à 4 · Post et Story

LIENS DE RENDU SIGNÉS

Une adresse d'image qui se génère

Pour un e-mail, un CMS ou une balise img, sans clé API : le visuel se génère à l'ouverture, à la taille du format.

Valeurs fixéesLa signature couvre les valeurs : personne ne peut les changer dans l'adresse.

Valeurs modifiablesLa signature couvre le modèle seul : chaque valeur se remplace dans l'adresse.

Intégrer

<img src="https://suwar.app/v/…/post.png?sujet=pubs&sig=…"
     width="1080" height="1350" alt="Des pubs qui vendent">

Des pubsqui vendent,dès lundi →1 crédit à la première ouverture avec de nouvelles valeurs ; les mêmes valeurs renvoient le visuel déjà généré pendant 24 heures.

https://hooks.votre-outil.com/suwar

Actif

3 événements : render.completed, render.failed, form.submittedDernier envoi : 200 · il y a 2 min

Envoi

X-Suwar-Signature: sha256=5f2c…

{
  "event": "render.completed",
  "timestamp": "2026-10-08T09:30:00.000Z",
  "data": { "templateId": "…", "renderId": "…" }
}

Vérifier la signature (Node)

const attendu = 'sha256=' + crypto
  .createHmac('sha256', process.env.SUWAR_WEBHOOK_SECRET)
  .update(corpsBrut).digest('hex');

WEBHOOKS

Vos outils prévenus dès que c'est prêt

Un POST JSON signé à chaque événement coché ; sans réponse en 10 secondes, deux nouvelles tentatives, après 2 puis 4 secondes.

render.completedUn visuel est prêt

render.failedUn rendu a échoué, avec le message d'erreur

template.createdUn modèle est créé

template.updatedUn modèle est enregistré

template.deletedUn modèle part à la corbeille

form.submittedUn formulaire public est envoyé, avec les valeurs saisies

SERVEUR MCP

Un agent pilote Suwar

Claude et les agents compatibles créent, remplissent et génèrent vos modèles en conversation. Chaque membre autorise l'accès avec son propre compte.

claude mcp add --transport http suwar <adresse du serveur>

Modèleslister, lire, créer, modifier, dupliquer

Variantescréer, modifier, détacher

Rendusun visuel, un carrousel, un tableur entier, un catalogue PDF

Tableurscréer, lire, ajouter des lignes

Médiasimporter, lister, détourer

Marques et policescréer une marque, l'appliquer

Décline « Grand titre sur photo » en Story pour les 12 lignes de Campagne d'automne.

render_dataset_batch12 lignes · Story 1080 × 1920

12 visuels prêts

API ET MCP

Piloter par l'API ou un agent

« Nos agents IA doivent pouvoir le faire seuls. » REST, liens de rendu signés, webhooks et serveur MCP.

OUTILS

Des clés, des quotas, des exemples

Tout ce qu'il faut pour brancher Suwar sur vos outils.

Clés API

sk_live_••••••••••••

Projet

Rendu

Lecture des modèles

Tableurs

Écriture des modèles

Une clé par outil, limitée à un projet et à des permissions ; expiration à 30 jours, 90 jours, 1 an ou jamais. Une clé de test filigrane « TEST » et ne consomme rien.

Quotas et erreurs

3 000 requêtes par quart d'heure

401Clé absente, révoquée ou expirée

403Permission manquante

404Modèle introuvable, ou hors du projet de la clé

429Plus de 3 000 requêtes en un quart d'heure

Exemples prêts à copier

« Démarrage rapide » prépare la requête pour votre dernier modèle, en cURL, Node ou Python. Une API REST en JSON : un appel HTTP suffit, depuis un site, un back-office ou une automatisation.

cURL

Node

Python

Make

n8n

Zapier

DOCUMENTATION

La référence de l'API

Paramètres, réponses, erreurs et exemples, point d'accès par point d'accès.

Lire la documentation

POST/api/v1/renderRendre un modèle : format, fichier, variables

GET/api/v1/render/{modèle}.pngLe fichier du format de base, directement

GET/api/renders/{id}Lire un rendu et l'adresse du fichier

POST/api/v1/remove-bgDétourer des images

DÉVELOPPEURS

Votre première requête en quelques minutes

Créer une clé de test, coller la requête, voir le visuel arriver.

Essayer gratuitement Lire la documentation