Technical documentation

API for developers

Integrate PictoHouse into your applications with our complete REST API and SDKs

Quick start

Start using the API in minutes

cURL

curl -X POST "https://api.pictohouse.com/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "photos": [
      "https://example.com/photo1.jpg",
      "https://example.com/photo2.jpg"
    ],
    "template": "modern_slideshow",
    "settings": {
      "duration": 30,
      "format": "16:9"
    }
  }'

JavaScript

const response = await fetch('https://api.pictohouse.com/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    photos: [
      'https://example.com/photo1.jpg',
      'https://example.com/photo2.jpg'
    ],
    template: 'modern_slideshow',
    settings: {
      duration: 30,
      format: '16:9'
    }
  })
});

const video = await response.json();
console.log('Video ID:', video.id);

Python

import requests

url = "https://api.pictohouse.com/v1/videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "photos": [
        "https://example.com/photo1.jpg",
        "https://example.com/photo2.jpg"
    ],
    "template": "modern_slideshow",
    "settings": {
        "duration": 30,
        "format": "16:9"
    }
}

response = requests.post(url, headers=headers, json=data)
video = response.json()
print(f"Video ID: {video['id']}")

Authentication

Use your API key to authenticate your requests

Authorization: Bearer YOUR_API_KEY

Secure

All requests are encrypted via HTTPS

Rate limits

100 requests per minute by default

Main endpoints

POST/api/videosCreate a new video

GET/api/videos/{id}Retrieve a video

GET/api/videosList your videos

Webhooks

Receive real-time notifications when your videos are ready.

{
  "event": "video.completed",
  "video_id": "vid_1234567890",
  "status": "completed",
  "download_url": "https://api.pictohouse.com/v1/videos/vid_1234567890/download",
  "created_at": "2024-01-15T10:30:00Z"
}

Ready to get started?

Start integrating PictoHouse into your applications right now.

Generate my API key Complete documentation