REST API · JSON · API key auth

Picnie API Reference

Automate image generation, editing, compression, watermarks, background removal, and OCR with Picnie REST APIs. This page mirrors the official docs.picnie.com reference - every endpoint links to full request/response documentation.

API Overview

Picnie enables you to automatically generate social media visuals, display ads, and website banners using REST APIs, integrations, or no-code tools at scale. Generate images, PDFs, certificates, and marketing assets from templates - plus utilities for background removal, OCR, watermarking, and optimization.

Authentication

All endpoints require your API key in the Authorization header. Obtain a key from your Picnie dashboard.

Base URL
https://picnie.com/api/v1
EndpointDescriptionUse case
Create ProjectCreate a new project workspace to manage and organize image operations.Batch process images by event, client, or campaign.
Get My ProjectsRetrieve a list of your created projects.Display and manage project history in a dashboard.
Get TemplateFetch pre-built image templates with dynamic fields.Generate certificates, ID cards, or event creatives.
Get My TemplatesList templates available in your Picnie account.Populate template pickers in your app or automation.
Create ImageFill a selected template with user data to generate images.Automate creation of personalized visuals at scale.
Create Image CollectionGenerate multiple images from a template collection in one request.Bulk campaigns with consistent layout across variants.
Create PDFGenerate PDF documents from Picnie templates (certificates, invoices, bills).Automate certificates and printable documents at scale.
Compress ImageReduce image file size with minimal quality loss.Optimize for web, email, or mobile delivery.
Resize ImageResize images to specific dimensions.Standardize for social media, banners, or thumbnails.
Convert ImageConvert images between formats (JPG, PNG, WEBP, GIF).Normalize assets for web, print, or platform requirements.
Crop ImageCrop to desired height/width with position control.Responsive UI crops, banners, or social media frames.
Remove BackgroundAI segmentation to remove image backgrounds.Create transparent product images or isolate subjects.
Enhance ImageAI upscale images by 2× or 4× with detail recovery.Sharpen low-res product photos, portraits and marketing assets.
Transcribe ImageExtract text content from images using OCR.Digitize receipts, IDs, or printed documents.
Filter on ImageApply visual filters and effects to images.Brand-consistent styling across automated pipelines.
Upload AssetUpload images and assets for use in templates and API workflows.Feed dynamic image URLs into Create Image and batch jobs.
Add Watermark Text on ImageAdd text watermark to protect brand identity.Watermark product photos, artwork, or stock images.
Add Watermark ImageOverlay a logo or image watermark on photos.Brand protection on catalogs and user-generated content.
Get Image MetadataRead metadata associated with processed images.Audit pipelines and debug automation outputs.
Add Image MetadataAttach custom metadata to images in your projects.Tag assets for DAM, PIM, or downstream workflows.

Who can use Picnie APIs?

  • eCommerce platforms

    Automate product photo editing

  • Fintech & KYC

    Extract info from scanned documents

  • EdTech & events

    Generate certificates and badges

  • Creative tools

    Advanced image editing workflows

  • SaaS platforms

    White-labeled visual automation

Quick Start

Explore the official Picnie API to automate visual content creation. All requests and responses use JSON. Get your API key from the dashboard, then test every endpoint in the Postman collection.

  • Generating graphics with templates
  • Resizing and compressing images
  • Adding watermarks or frames
  • Removing backgrounds and OCR (transcribe image)

Example - Create Image

curl -X POST "https://picnie.com/api/v1/create-image" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "1",
    "template_id": 2020,
    "template_name": "Daily Motivation",
    "type": "image",
    "output_image_format": "png",
    "details": [
      { "name": "Title_0", "text": "Hello from Picnie" }
    ]
  }'

Full parameter reference: Create Image API docs · Quick start guide

Projects & templates

POST

Create Project

https://picnie.com/api/v1/create-project
Full documentation

Create a new project workspace to manage and organize image operations.

Use case: Batch process images by event, client, or campaign.

Request body, headers, and response examples are on docs.picnie.com/create-project. Try this endpoint in Postman.

POST

Get My Projects

https://picnie.com/api/v1/get-my-projects
Full documentation

Retrieve a list of your created projects.

Use case: Display and manage project history in a dashboard.

Request body, headers, and response examples are on docs.picnie.com/get-my-projects. Try this endpoint in Postman.

POST

Get Template

https://picnie.com/api/v1/get-template
Full documentation

Fetch pre-built image templates with dynamic fields.

Use case: Generate certificates, ID cards, or event creatives.

Request body, headers, and response examples are on docs.picnie.com/get-template. Try this endpoint in Postman.

POST

Get My Templates

https://picnie.com/api/v1/get-my-templates
Full documentation

List templates available in your Picnie account.

Use case: Populate template pickers in your app or automation.

Request body, headers, and response examples are on docs.picnie.com/get-my-templates. Try this endpoint in Postman.

Generation

POST

Create Image

https://picnie.com/api/v1/create-image
Full documentation

Fill a selected template with user data to generate images.

Use case: Automate creation of personalized visuals at scale.

Request body, headers, and response examples are on docs.picnie.com/create-image. Try this endpoint in Postman.

POST

Create Image Collection

https://picnie.com/api/v1/create-image-collection
Full documentation

Generate multiple images from a template collection in one request.

Use case: Bulk campaigns with consistent layout across variants.

Request body, headers, and response examples are on docs.picnie.com/create-image-collection. Try this endpoint in Postman.

POST

Create PDF

https://picnie.com/api/v1/create-pdf
Full documentation

Generate PDF documents from Picnie templates (certificates, invoices, bills).

Use case: Automate certificates and printable documents at scale.

Request body, headers, and response examples are on docs.picnie.com/create-pdf. Try this endpoint in Postman.

Image processing

POST

Compress Image

https://picnie.com/api/v1/compress-image
Full documentation

Reduce image file size with minimal quality loss.

Use case: Optimize for web, email, or mobile delivery.

Request body, headers, and response examples are on docs.picnie.com/compress-image. Try this endpoint in Postman.

POST

Resize Image

https://picnie.com/api/v1/resize-image
Full documentation

Resize images to specific dimensions.

Use case: Standardize for social media, banners, or thumbnails.

Request body, headers, and response examples are on docs.picnie.com/resize-image. Try this endpoint in Postman.

POST

Convert Image

https://picnie.com/api/v1/convert-image
Full documentation

Convert images between formats (JPG, PNG, WEBP, GIF).

Use case: Normalize assets for web, print, or platform requirements.

Request body, headers, and response examples are on docs.picnie.com/convert-image. Try this endpoint in Postman.

POST

Crop Image

https://picnie.com/api/v1/crop-image
Full documentation

Crop to desired height/width with position control.

Use case: Responsive UI crops, banners, or social media frames.

Request body, headers, and response examples are on docs.picnie.com/crop-image. Try this endpoint in Postman.

POST

Remove Background

https://picnie.com/api/v1/remove-background
Full documentation

AI segmentation to remove image backgrounds.

Use case: Create transparent product images or isolate subjects.

Request body, headers, and response examples are on docs.picnie.com/remove-background. Try this endpoint in Postman.

POST

Enhance Image

https://picnie.com/api/v1/enhance-image
Full documentation

AI upscale images by 2× or 4× with detail recovery.

Use case: Sharpen low-res product photos, portraits and marketing assets.

Request body, headers, and response examples are on docs.picnie.com/enhance-image. Try this endpoint in Postman.

POST

Transcribe Image

https://picnie.com/api/v1/transcribe-image
Full documentation

Extract text content from images using OCR.

Use case: Digitize receipts, IDs, or printed documents.

Request body, headers, and response examples are on docs.picnie.com/transcribe-image. Try this endpoint in Postman.

POST

Filter on Image

https://picnie.com/api/v1/filter-on-image
Full documentation

Apply visual filters and effects to images.

Use case: Brand-consistent styling across automated pipelines.

Request body, headers, and response examples are on docs.picnie.com/filter-on-image. Try this endpoint in Postman.

Assets, watermarks & metadata

POST

Upload Asset

https://picnie.com/api/v1/upload-asset
Full documentation

Upload images and assets for use in templates and API workflows.

Use case: Feed dynamic image URLs into Create Image and batch jobs.

Request body, headers, and response examples are on docs.picnie.com/upload-asset. Try this endpoint in Postman.

POST

Add Watermark Image

https://picnie.com/api/v1/add-watermark-image
Full documentation

Overlay a logo or image watermark on photos.

Use case: Brand protection on catalogs and user-generated content.

Request body, headers, and response examples are on docs.picnie.com/add-watermark-image. Try this endpoint in Postman.

POST

Get Image Metadata

https://picnie.com/api/v1/get-image-metadata
Full documentation

Read metadata associated with processed images.

Use case: Audit pipelines and debug automation outputs.

Request body, headers, and response examples are on docs.picnie.com/get-image-metadata. Try this endpoint in Postman.

POST

Add Image Metadata

https://picnie.com/api/v1/add-image-metadata
Full documentation

Attach custom metadata to images in your projects.

Use case: Tag assets for DAM, PIM, or downstream workflows.

Request body, headers, and response examples are on docs.picnie.com/add-image-metadata. Try this endpoint in Postman.

Contact & support

Questions or enterprise usage? Email support@picnie.com. Official reference lives at https://docs.picnie.com/api-reference.

🧭 Let Picnie handle the visuals - you build the experience.

Ready to ship image features?

Get your API key, try endpoints in Postman, then wire Picnie into your product.