Tool Schemas
Use these JSON schemas to integrate Pictify with AI agents, function calling, and tool-use systems.Image Generation
Create Image
{
"name": "pictify_create_image",
"description": "Generate an image from HTML content. Supports PNG, JPEG, and WebP formats. Use for creating social media graphics, banners, cards, and any visual content from HTML/CSS.",
"input_schema": {
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "HTML content to render. Can include inline CSS and external fonts."
},
"width": {
"type": "integer",
"description": "Output width in pixels (1-4000)",
"minimum": 1,
"maximum": 4000
},
"height": {
"type": "integer",
"description": "Output height in pixels (1-4000)",
"minimum": 1,
"maximum": 4000
},
"format": {
"type": "string",
"enum": ["png", "jpeg", "webp"],
"default": "png",
"description": "Output image format"
},
"quality": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 85,
"description": "Quality for JPEG/WebP (1-100)"
},
"transparent": {
"type": "boolean",
"default": false,
"description": "Enable transparent background (PNG/WebP only)"
}
},
"required": ["html", "width", "height"]
}
}
Screenshot URL
{
"name": "pictify_screenshot",
"description": "Capture a screenshot of a web page. Use for documentation, comparisons, or archiving web content.",
"input_schema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "URL to screenshot (must be publicly accessible)"
},
"width": {
"type": "integer",
"default": 1200,
"description": "Viewport width in pixels"
},
"height": {
"type": "integer",
"default": 630,
"description": "Viewport height in pixels"
},
"fullPage": {
"type": "boolean",
"default": false,
"description": "Capture the full scrollable page"
},
"selector": {
"type": "string",
"description": "CSS selector to capture specific element"
},
"waitForSelector": {
"type": "string",
"description": "Wait for element before capturing"
}
},
"required": ["url"]
}
}
Template Operations
Render Template
{
"name": "pictify_render_template",
"description": "Render a saved template with dynamic variables. Use for generating personalized images from pre-designed templates.",
"input_schema": {
"type": "object",
"properties": {
"templateId": {
"type": "string",
"description": "Template ID (e.g., tmpl_abc123)"
},
"variables": {
"type": "object",
"description": "Variables to inject into the template",
"additionalProperties": true
},
"format": {
"type": "string",
"enum": ["png", "jpeg", "webp"],
"default": "png"
}
},
"required": ["templateId"]
}
}
List Templates
{
"name": "pictify_list_templates",
"description": "List available templates. Use to discover what templates are available before rendering.",
"input_schema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"description": "Maximum number of templates to return"
},
"page": {
"type": "integer",
"default": 1,
"description": "Page number for pagination"
}
}
}
}
Get Template Variables
{
"name": "pictify_get_template_variables",
"description": "Get the list of variables required by a template. Use before rendering to understand what data is needed.",
"input_schema": {
"type": "object",
"properties": {
"templateId": {
"type": "string",
"description": "Template ID to get variables for"
}
},
"required": ["templateId"]
}
}
GIF Generation
Create GIF
{
"name": "pictify_create_gif",
"description": "Create an animated GIF from HTML with CSS animations. Use for loading spinners, animated banners, or any looping animation.",
"input_schema": {
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "HTML content with CSS animations"
},
"width": {
"type": "integer",
"description": "GIF width in pixels (max 1200)",
"maximum": 1200
},
"height": {
"type": "integer",
"description": "GIF height in pixels (max 1200)",
"maximum": 1200
},
"quality": {
"type": "string",
"enum": ["low", "medium", "high"],
"default": "medium",
"description": "Quality preset affecting frame rate and duration"
}
},
"required": ["html", "width", "height"]
}
}
Capture GIF from URL
{
"name": "pictify_capture_gif",
"description": "Record a GIF from a live web page. Use for capturing animations or interactions on existing websites.",
"input_schema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "URL to capture"
},
"width": {
"type": "integer",
"default": 800,
"description": "Capture width"
},
"height": {
"type": "integer",
"default": 600,
"description": "Capture height"
},
"duration": {
"type": "number",
"default": 5,
"description": "Recording duration in seconds"
},
"quality": {
"type": "string",
"enum": ["low", "medium", "high"],
"default": "medium"
}
},
"required": ["url"]
}
}
PDF Generation
Render PDF
{
"name": "pictify_render_pdf",
"description": "Generate a PDF from a template. Use for invoices, reports, certificates, and other documents.",
"input_schema": {
"type": "object",
"properties": {
"templateId": {
"type": "string",
"description": "Template ID to render"
},
"variables": {
"type": "object",
"description": "Variables for the template"
},
"preset": {
"type": "string",
"enum": ["A4", "Letter", "Legal", "A3", "A5", "custom"],
"default": "A4",
"description": "Paper size preset"
},
"landscape": {
"type": "boolean",
"default": false,
"description": "Use landscape orientation"
},
"margins": {
"type": "object",
"properties": {
"top": { "type": "number" },
"bottom": { "type": "number" },
"left": { "type": "number" },
"right": { "type": "number" }
},
"description": "Page margins in pixels"
}
},
"required": ["templateId"]
}
}
OpenAI Function Calling Format
For OpenAI’s function calling, use this format:{
"type": "function",
"function": {
"name": "pictify_create_image",
"description": "Generate an image from HTML content",
"parameters": {
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "HTML content to render"
},
"width": {
"type": "integer",
"description": "Width in pixels"
},
"height": {
"type": "integer",
"description": "Height in pixels"
}
},
"required": ["html", "width", "height"]
}
}
}
Anthropic Tool Use Format
For Claude’s tool use:{
"name": "pictify_create_image",
"description": "Generate an image from HTML content. Returns a URL to the generated image.",
"input_schema": {
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "HTML content to render"
},
"width": {
"type": "integer",
"description": "Width in pixels (1-4000)"
},
"height": {
"type": "integer",
"description": "Height in pixels (1-4000)"
}
},
"required": ["html", "width", "height"]
}
}
Response Schemas
Image Response
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "CDN URL of the generated image"
},
"id": {
"type": "string",
"description": "Unique image identifier"
},
"width": {
"type": "integer",
"description": "Actual image width"
},
"height": {
"type": "integer",
"description": "Actual image height"
},
"format": {
"type": "string",
"description": "Image format"
},
"size": {
"type": "integer",
"description": "File size in bytes"
}
}
}
Error Response
{
"type": "object",
"properties": {
"type": {
"type": "string",
"format": "uri",
"description": "Error type URI"
},
"title": {
"type": "string",
"description": "Error title"
},
"status": {
"type": "integer",
"description": "HTTP status code"
},
"detail": {
"type": "string",
"description": "Detailed error message"
}
}
}
Usage Examples
OpenAI
import openai
response = openai.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "Create a social card for my blog post about AI"}],
tools=[{
"type": "function",
"function": {
"name": "pictify_create_image",
"description": "Generate an image from HTML",
"parameters": {
"type": "object",
"properties": {
"html": {"type": "string"},
"width": {"type": "integer"},
"height": {"type": "integer"}
},
"required": ["html", "width", "height"]
}
}
}]
)
Anthropic
import anthropic
response = anthropic.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
tools=[{
"name": "pictify_create_image",
"description": "Generate an image from HTML",
"input_schema": {
"type": "object",
"properties": {
"html": {"type": "string"},
"width": {"type": "integer"},
"height": {"type": "integer"}
},
"required": ["html", "width", "height"]
}
}],
messages=[{"role": "user", "content": "Create a social card for my blog post"}]
)