Générer des images au lieu de PDF

Dernière mise à jour le 23 mars 2026

PDFMonkey génère des PDF par défaut, mais les modèles avec le type de sortie Image produisent des images WebP, PNG ou JPG à la place. Le flux API est identique ; seul le type de modèle et quelques options meta diffèrent.

Créer un modèle image

Pour générer des images, vous avez besoin d’un modèle configuré pour la sortie image. Sélectionnez Image comme type de sortie lors de la création de votre modèle :

Astuce

Vous pouvez également dupliquer un modèle existant et changer son type de sortie en Image.

Pourquoi des types de modèles distincts ?

Les PDF et les images ont des capacités fondamentalement différentes. Les documents PDF prennent en charge les en-têtes, pieds de page et différents formats de papier. Les modèles images prennent en charge les arrière-plans transparents et des dimensions en pixels à la place.

Une fois le modèle créé, ouvrez ses paramètres pour configurer :

  • Largeur et hauteur : en pixels (500 x 500 par défaut)
  • Arrière-plan transparent : pris en charge par WebP et PNG

Générer une image via l’API

Générez une image de la même manière que vous générez un PDF : envoyez une requête POST à /api/v1/documents (ou /api/v1/documents/sync pour la génération synchrone). Tant que le document_template_id pointe vers un modèle image, PDFMonkey produit une image au lieu d’un PDF.

curl https://api.pdfmonkey.io/api/v1/documents \
  -X POST \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "document": {
      "document_template_id": "YOUR_IMAGE_TEMPLATE_ID",
      "status": "pending",
      "payload": { "title": "Hello World" }
    }
  }'

Par défaut, une image WebP est créée. Le WebP offre une bonne qualité pour une taille de fichier raisonnable et prend en charge les arrière-plans transparents.

Options meta à la génération

Vous pouvez remplacer les valeurs par défaut du modèle à la génération en passant des clés spéciales dans le champ meta du document. Ces options ne s’appliquent qu’aux modèles images ; elles sont ignorées pour les modèles PDF.

CléTypeDescriptionDéfaut
_typestringFormat d’image : webp, png ou jpgwebp
_widthintegerLargeur de l’image en pixelsParamètre du modèle (500)
_heightintegerHauteur de l’image en pixelsParamètre du modèle (500)
_qualityintegerQualité de compression de 1 à 100 (WebP uniquement)100
{
  "document": {
    "document_template_id": "YOUR_IMAGE_TEMPLATE_ID",
    "payload": { "title": "Hello World" },
    "status": "pending",
    "meta": {
      "_type": "png",
      "_width": 1200,
      "_height": 630
    }
  }
}
L’option _quality ne s’applique qu’aux images WebP. Le PNG est toujours sans perte, et le JPG utilise un réglage de qualité fixe.
Pour les cartes de réseaux sociaux et les images Open Graph, 1200x630 est la taille la plus couramment recommandée. Passez "_type": "png" pour une compatibilité maximale.

Arrière-plans transparents

La transparence est contrôlée dans les paramètres du modèle, pas à la génération. Activez-la lorsque vous avez besoin d’images sans arrière-plan (utile pour les logos, filigranes et éléments superposés).

Les arrière-plans transparents sont pris en charge par WebP et PNG. Le JPG ne prend pas en charge la transparence : les zones transparentes sont rendues en blanc.

Noms de fichiers personnalisés pour les images

La clé meta _filename fonctionne de la même manière pour les images que pour les PDF (voir Nom de fichier personnalisé). PDFMonkey ajoute automatiquement la bonne extension (.webp, .png ou .jpg) :

{
  "meta": {
    "_filename": "social-card-march",
    "_type": "png"
  }
}

Cela produit un fichier nommé social-card-march.png.

Questions fréquentes

Que se passe-t-il si j’utilise les options meta image sur un modèle PDF ?

Elles sont ignorées. Les clés meta _type, _width, _height et _quality n’affectent que les modèles images.

Peut-on changer le format de sortie d’un modèle existant ?

Oui. Ouvrez les paramètres du modèle dans le Dashboard et changez le type de sortie. Les documents existants générés à partir du modèle ne sont pas affectés ; seuls les nouveaux documents utilisent le paramètre mis à jour.

Y a-t-il une taille d’image maximale ?

Il n’y a pas de limite stricte en pixels, mais les images très grandes (au-delà de 4000 x 4000 px) augmentent le temps de génération et la consommation mémoire. Gardez des dimensions raisonnables pour votre cas d’usage.

Les webhooks fonctionnent-ils avec la génération d’images ?

Oui. Les webhooks se déclenchent sur documents.generation.success et documents.generation.failure quel que soit le type de sortie.

Pages associées

Questions fréquentes

PDFMonkey peut-il générer des images au lieu de PDF ?
Oui. PDFMonkey prend en charge la génération d’images WebP, PNG et JPG en plus des PDF. Créez un modèle avec le type de sortie Image, puis utilisez les mêmes endpoints API pour générer des images.
Quel est le format d’image par défaut dans PDFMonkey ?
Le WebP est le format par défaut pour les modèles images. Il offre une bonne qualité pour une taille de fichier réduite et prend en charge les arrière-plans transparents. Vous pouvez le modifier en passant _type: png ou _type: jpg dans les métadonnées du document.
Comment définir les dimensions d’une image générée ?
Définissez les dimensions par défaut dans les paramètres du modèle (largeur et hauteur en pixels, 500x500 par défaut). Vous pouvez les modifier à la génération en passant _width et _height dans les métadonnées du document.
Navigation