Back to Blog

Using the Picture-in-Picture API with FFMPEGAPI.net for Video Overlays

June 2026 FFMPEG API Team

In today's digital landscape, video content is king. Whether you're building a SaaS app, automating video workflows, or enhancing content pipelines, having a powerful and easy-to-use video processing tool is essential. FFMPEGAPI.net offers a hosted solution for developers looking to leverage FFmpeg’s capabilities without the complexity of server management. In this article, we will explore the Picture-in-Picture (PiP) feature of FFMPEGAPI.net, which allows you to overlay one video on another with ease.

What is the Picture-in-Picture API?

The Picture-in-Picture API from FFMPEGAPI.net enables developers to create engaging video compositions by overlaying a secondary video on a main video. This feature is particularly useful for applications that require commentary, tutorials, or additional visual context.

  • Overlay one video on another with configurable position and scale.
  • Adjust audio sources between the main video and overlay.
  • Effortlessly integrate into automation and SaaS applications.

Endpoint Overview

The Picture-in-Picture API is accessed via a simple POST request to the endpoint: /api/picture_in_picture. You can provide parameters like video URLs, position, scale, and audio options to customize your video overlay.

  • Endpoint: /api/picture_in_picture
  • Method: POST
  • Content Type: application/json

Required and Optional Parameters

To use the Picture-in-Picture API effectively, you'll need to provide the following parameters:

The main_video_url and pip_video_url are mandatory, while position, scale, audio_option, and async are optional. The defaults for position and scale are bottom-right and iw/4:ih/4, respectively.

  • main_video_url: URL of the background video (required)
  • pip_video_url: URL of the overlay video (required)
  • position: Overlay position (optional; defaults to bottom-right)
  • scale: FFmpeg scale expression (optional; defaults to iw/4:ih/4)
  • audio_option: Choose audio source (optional; defaults to video1)
  • async: Process in the background (optional)

Making Your First Request

Here's how you can make your first API call to create a Picture-in-Picture video composition. Below are examples in both cURL and Python to demonstrate how straightforward it is to get started.

curl -X POST https://ffmpegapi.net/api/picture_in_picture \ 
-H 'Content-Type: application/json' \ 
-d '{"main_video_url": "https://example.com/main.mp4", "pip_video_url": "https://example.com/overlay.mp4", "position": "top-right"}'
import requests

url = 'https://ffmpegapi.net/api/picture_in_picture'

payload = {
    'main_video_url': 'https://example.com/main.mp4',
    'pip_video_url': 'https://example.com/overlay.mp4',
    'position': 'top-right'
}

response = requests.post(url, json=payload)
print(response.json())

FFMPEGAPI.net provides a robust, cloud-based solution for developers looking to simplify video processing tasks like creating Picture-in-Picture compositions. With no need for server setup and straightforward API-key authentication, you can focus on building powerful applications that enhance user engagement. Start leveraging the Picture-in-Picture API today and take your video content to the next level.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free