Introduction
Pipevideo HTTP API — endpoints, authentication, and client libraries.
The Pipevideo API is a REST interface for video generation. It uses an OpenAI Responses-compatible shape with Pipevideo-specific extensions for video output.
Base URL: https://api.pipevideo.co/v1
API overview
Base URL, content types, and request conventions.
Authentication
API keys and Bearer token authentication.
Responses
Create and retrieve video generations.
TypeScript SDK
npm install pipevideo — typed client for Node.js and edge runtimes.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
GET | /v1/engines | Public | List engines and orchestration models |
POST | /v1/responses | API key | Create a video generation |
GET | /v1/responses/{id} | API key | Get generation status and result |
DELETE | /v1/responses/{id} | API key | Cancel an in-flight generation |
GET | /v1/usage | API key | Usage stats, balance, and breakdown |
Client options
| Approach | Best for |
|---|---|
| REST API | Any language, full control |
| TypeScript SDK | Node.js and edge runtimes with typed helpers |
| OpenAI SDK | Existing OpenAI integrations — change baseURL and use responses.create |
| MCP server | AI assistants and agent frameworks |