Introduction

Get started with the Pictograph SDK for programmatic access to your annotation data.

Welcome to the Pictograph Developer Documentation. The Pictograph SDK provides programmatic access to your computer vision datasets, annotations, and exports.

Download Datasets

Fetch annotated images and annotations in Pictograph JSON or COCO format.

Upload Images

Add new images to your datasets programmatically via signed URLs.

Manage Annotations

Create, read, and update bounding boxes, polygons, polylines, and keypoints.

Create Exports

Generate downloadable ZIP archives for training ML models.

Quick Example

Install the SDK and start working with your data in minutes:

Bash

pip install pictograph

Python

from pictograph import Client

# Initialize with your API key
client = Client(api_key="pk_live_your_key_here")

# List all datasets in your organization
datasets = client.datasets.list()
for dataset in datasets:
    print(f"{dataset['name']}: {dataset['image_count']} images")

# Download a dataset to local directory
client.datasets.download(
    "my-dataset",
    output_dir="./data",
    max_workers=20  # Parallel downloads
)

# Get annotations for an image
annotations = client.annotations.get("image-uuid")
for ann in annotations:
    print(f"{ann['name']} ({ann['type']})")

SDK Version

Current version: 0.1.10

The SDK requires Python 3.8 or later and has minimal dependencies (requests, Pillow, tqdm).

Base URL

All API requests are made to: https://api.pictograph.io

Next Steps

Installation - Set up the SDK in your project
Quick Start - Common workflows and examples
Authentication - Get and use your API key
API Reference - Complete endpoint documentation

Getting Help

If you run into issues or have questions, email support@pictograph.io.