PlayVideo LangChain Tools

LangChain tools for PlayVideo API. Enables AI agents to upload, transcode, and manage videos autonomously.

What is LangChain?

LangChain is the most popular framework for building AI agent applications. This package provides a toolkit of tools that any LangChain agent can use to work with videos — from cost estimation to upload to embedding.

Features

• Cost Estimation - Check prices before committing (budget-aware agents)
• Collections - Create and list video collections
• Videos - Upload, list, get details, delete
• Webhooks - Create webhooks for processing notifications
• Usage - Monitor spend and cost breakdown
• Upload Instructions - Get cURL/SDK commands for uploading

Installation

npm install @playvideo/langchain @langchain/core

Quick Start

import { PlayVideoToolkit } from "@playvideo/langchain";
import { ChatOpenAI } from "@langchain/openai";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

// Create the toolkit with your API key
const toolkit = new PlayVideoToolkit({ apiKey: "play_live_xxx" });

// Create a LangChain agent with PlayVideo tools
const llm = new ChatOpenAI({ model: "gpt-4o" });
const agent = createReactAgent({ llm, tools: toolkit.getTools() });

// The agent can now manage videos autonomously
const result = await agent.invoke({
  messages: [{ 
    role: "user", 
    content: "Create a collection called 'tutorials' and tell me how to upload a video to it" 
  }],
});

Usage Examples

Once your agent has the PlayVideo tools, it can handle requests like:

• "How much would it cost to transcode a 10-minute video?"
• "Create a collection called 'product-demos'"
• "List all my completed videos"
• "Get the streaming URL for video abc123"
• "Set up a webhook to notify me when videos finish processing"
• "What's my current usage this month?"
• "Delete the video xyz789"
• "Show me how to upload a video to the 'tutorials' collection"

Available Tools

| Tool | Description | |------|-------------| | playvideo_estimate_cost | Estimate cost of an operation (no API key needed) | | playvideo_list_collections | List all video collections | | playvideo_create_collection | Create a new collection | | playvideo_upload_video | Get upload instructions (cURL + SDK) | | playvideo_list_videos | List videos (filter by collection/status) | | playvideo_get_video | Get video details and streaming URLs | | playvideo_delete_video | Delete a video | | playvideo_get_usage | Get monthly spend and cost breakdown | | playvideo_create_webhook | Create a webhook for processing events |

Agent Frameworks

ReAct Agent (LangGraph)

import { createReactAgent } from "@langchain/langgraph/prebuilt";

const toolkit = new PlayVideoToolkit({ apiKey: "play_live_xxx" });
const agent = createReactAgent({ llm, tools: toolkit.getTools() });

OpenAI Functions Agent

import { createOpenAIFunctionsAgent } from "langchain/agents";

const toolkit = new PlayVideoToolkit({ apiKey: "play_live_xxx" });
const agent = await createOpenAIFunctionsAgent({ 
  llm, 
  tools: toolkit.getTools(), 
  prompt 
});

Tool Calling Agent

import { createToolCallingAgent } from "langchain/agents";

const toolkit = new PlayVideoToolkit({ apiKey: "play_live_xxx" });
const agent = await createToolCallingAgent({ 
  llm, 
  tools: toolkit.getTools(), 
  prompt 
});

How It Works

A typical agent workflow:

1. Agent receives a video task (e.g., "upload this video for streaming")
2. Agent calls playvideo_estimate_cost to check the price
3. Agent calls playvideo_create_collection if needed
4. Agent calls playvideo_upload_video to get upload instructions
5. Agent executes the upload (via cURL or SDK)
6. Agent calls playvideo_get_video to check processing status
7. Agent returns streaming URLs to the user

The agent handles the full workflow autonomously — from cost estimation to delivering playback URLs.

Configuration

const toolkit = new PlayVideoToolkit({
  apiKey: "play_live_xxx",                   // Required
  baseUrl: "https://api.playvideo.dev",      // Optional (default shown)
});

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PLAYVIDEO_API_KEY | Yes | Your PlayVideo API key |

You can pass the key directly or read from environment:

const toolkit = new PlayVideoToolkit({ 
  apiKey: process.env.PLAYVIDEO_API_KEY! 
});

Custom API URL

If you're self-hosting PlayVideo or using a custom endpoint:

const toolkit = new PlayVideoToolkit({
  apiKey: "play_live_xxx",
  baseUrl: "https://your-playvideo-instance.com",
});

Pricing

PlayVideo uses usage-based pricing — no tiers, no subscriptions:

| Action | Price | |--------|-------| | Transcode | $0.008/min per resolution | | Storage | $0.005/GB/month | | Bandwidth | $0.005/GB | | Webhooks | Free | | API calls | Free |

Free monthly allowance: 100 min transcode, 5 GB storage, 10 GB bandwidth. No credit card required.

Security

• API keys are only sent to PlayVideo servers via HTTPS
• Keys are never logged or exposed in tool outputs
• Each tool validates inputs with Zod schemas

License

MIT