Skip to main content
Picnie logo
  • Category: images & design
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 19
  • Triggers: 0
  • Slug: PICNIE
  • Version: 20261030_00

Tools

Slug: PICNIE_ADD_IMAGE_METADATAWrite EXIF-style metadata into a public JPEG image URL. This creates a processed output and may consume Picnie credits; Picnie’s metadata-key allowlist is not fully documented.

Input Parameters

object
required
EXIF-style key/value object. Documented keys include ImageDescription, Artist, Software, UserComment, Copyright, Make, Model, and DateTimeOriginal; Picnie may reject other keys.
string
required
Publicly accessible JPEG image URL.
string
required
Project ID that owns the operation output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_ADD_IMAGE_WATERMARKOverlay a public logo or image URL on a public background image while constraining the output to the required maximum width and height. This image-processing operation may consume Picnie credits.

Input Parameters

string ("top_left" | "top_center" | "top_right" | "middle_left" | "middle_center" | "middle_right" | "bottom_left" | "bottom_center" | "bottom_right")
required
Placement of the watermark on the background image.
integer
required
Maximum output width in pixels.
integer
required
Maximum output height in pixels.
string
required
Project ID that owns the operation output.
string
required
Publicly accessible logo or watermark image URL.
string
required
Publicly accessible background image URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_ADD_TEXT_WATERMARKOverlay styled text on a public image URL. This image-processing operation may consume Picnie credits; supported Picnie font filenames are not fully documented.

Input Parameters

string
required
Watermark text to overlay on the image.
number
Text opacity from 0.0 (transparent) through 1.0 (opaque).
integer
Padding around the watermark text in pixels.
string ("top-left" | "top-center" | "top-right" | "middle-left" | "middle-center" | "middle-right" | "bottom-left" | "bottom-center" | "bottom-right")
required
Placement of the watermark text.
integer
Clockwise text rotation in degrees.
integer
required
Font size in pixels.
string
required
Publicly accessible source image URL.
string
required
Text color as a six-digit hex value including the leading #.
string
required
Project ID that owns the operation output.
string
required
Picnie-supported font filename from your template or account configuration, not a filesystem path or URL. Picnie does not provide an API for discovering valid filenames, so do not guess this value.
string
Text-background color as a six-digit hex value including the leading #.
number
Text-background opacity from 0.0 (transparent) through 1.0 (opaque).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_APPLY_IMAGE_FILTERApply one supported Picnie visual filter to a public image URL. This operation may consume Picnie credits.

Input Parameters

string ("negate" | "grayscale" | "edge_detect" | "emboss" | "gaussian_blur" | "selective_blur" | "mean_removal")
required
Visual filter to apply.
string
required
Publicly accessible source image URL.
string
required
Project ID that owns the operation output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_COMPRESS_IMAGECompress a public image URL at a selected Picnie quality and optionally change its format. This operation may consume Picnie credits.

Input Parameters

integer
required
Picnie compression quality from 55 (smallest and lowest quality) through 70 (largest and highest quality).
string
required
Publicly accessible source image URL.
string
required
Project ID that owns the operation output.
string ("original" | "jpg" | "png" | "webp")
Output format, or original to preserve the source format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_CONVERT_IMAGEConvert a public image URL to WebP, JPEG, or PNG without asking the agent to choose a compression quality. This operation may consume Picnie credits.

Input Parameters

string
required
Publicly accessible source image URL.
string
required
Project ID that owns the operation output.
string ("webp" | "jpg" | "png")
required
Target image format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_CREATE_IMAGEGenerate one image from a stored Picnie template and dynamic field replacements. This operation may consume Picnie credits.

Input Parameters

string
required
Destination project ID from List Projects.
integer
required
Image template ID from List Templates.
array
required
Dynamic template replacements. Every item needs a field name and exactly one of text or image_url.
string
required
Exact template name associated with template_id.
string ("jpg" | "png" | "gif" | "webp")
Rendered image format.
string ("Maximum" | "High" | "Medium" | "Low")
Rendered image quality.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_CREATE_IMAGE_COLLECTIONGenerate multiple images from a Picnie template group and shared replacements. This can consume multiple Picnie credits in one call.

Input Parameters

string
required
Destination project ID from List Projects.
array
required
Shared dynamic replacements. Each item requires a field name and exactly one of text or image_url.
integer
required
Template group ID to render.
string ("jpg" | "png" | "gif" | "webp")
Rendered image format.
string ("Maximum" | "High" | "Medium" | "Low")
Rendered image quality.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_CREATE_PDFGenerate a PDF from a stored Picnie template and dynamic field replacements. This operation may consume Picnie credits.

Input Parameters

string
required
Destination project ID from List Projects.
integer
required
PDF template ID from List Templates.
array
required
Dynamic template replacements. Every item needs a field name and exactly one of text or image_url.
string
required
Exact template name associated with template_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_CREATE_PROJECTCreate a persistent Picnie project for organizing generated and processed media. Picnie exposes no project deletion endpoint, so use this only when a new project is actually needed.

Input Parameters

string
required
Name for the new project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_CROP_IMAGECrop a public image URL to fixed dimensions using horizontal and vertical origin alignment. This operation may consume Picnie credits.

Input Parameters

integer
required
Crop width in pixels.
integer
required
Crop height in pixels.
string
required
Publicly accessible source image URL.
string
required
Project ID that owns the operation output.
string ("top" | "center" | "bottom")
Vertical region to retain.
string ("left" | "center" | "right")
Horizontal region to retain.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_GET_IMAGE_METADATARead dimensions, file properties, and EXIF metadata from a public JPEG image URL. Picnie processing may consume credits even though this tool is read-only from the agent’s perspective.

Input Parameters

string
required
Publicly accessible JPEG image URL.
string
required
Project ID used to authorize the metadata operation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_GET_TEMPLATEGet a Picnie template’s complete layout and simplified dynamic fields for constructing generation replacements.

Input Parameters

string
required
Template ID from List Templates. Numeric-looking IDs are accepted as strings and resolved by Picnie.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_LIST_PROJECTSList all projects belonging to the connected Picnie account, including IDs needed by generation and processing tools.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_LIST_TEMPLATESList templates available to the connected Picnie account so an agent can select inputs for image or PDF generation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_REMOVE_IMAGE_BACKGROUNDUse Picnie AI to remove the background from a public image URL. This operation may consume Picnie credits.

Input Parameters

string
required
Publicly accessible source image URL.
string
required
Project ID that owns the operation output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_RESIZE_IMAGEResize a public image URL either to explicit pixel dimensions or by percentage. This operation may consume Picnie credits.

Input Parameters

integer
Target width in pixels; required when resize_type is dimensions and forbidden for percentage.
integer
Target height in pixels; required when resize_type is dimensions and forbidden for percentage.
string
required
Publicly accessible source image URL.
string
required
Project ID that owns the operation output.
string ("dimensions" | "percentage")
required
Use dimensions for explicit width and height, or percentage for proportional scaling.
number
Scale percentage; required when resize_type is percentage and forbidden for dimensions.
boolean
Do not enlarge an image that is already smaller than the requested size.
boolean
Maintain the original aspect ratio when resizing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_TRANSCRIBE_IMAGEExtract text from a public image URL with Picnie OCR. This operation may consume Picnie credits; Picnie currently documents only Original for method and language.

Input Parameters

string
Picnie OCR method. Original is the only documented value; pass another value only when it is known to be supported by the connected account.
string
Picnie OCR language selector. Original is the only documented value; pass another value only when it is known to be supported.
string
required
Publicly accessible image URL to transcribe.
string
required
Project ID used for the OCR operation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PICNIE_UPLOAD_ASSETUpload an image file to the connected Picnie account’s persistent media library and return its public URL. Supported formats, size limits, and deletion behavior are not documented.

Input Parameters

object
required
Image file to upload. Picnie does not document accepted formats or maximum size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not