Quickstart

1. Create an account

Sign up at pipevideo.co. If your team already uses Pipevideo, accept an organization invite from your admin.

2. Add credits

Open Billing in the dashboard and add funds. Video generation requires a positive credit balance before requests are accepted.

3. Create an API key

Go to API Keys and create a key. Copy it immediately — it is shown only once. Keys are prefixed with pv_ for easy detection in logs and secret scanners.

4. List engines and models

Discover available rendering engines and orchestration models:

curl https://api.pipevideo.co/v1/engines

Each engine lists supported_models with token pricing (input and output per million tokens, including Pipevideo's premium).

5. Generate a video

Submit a generation request using the Responses API shape:

curl -X POST https://api.pipevideo.co/v1/responses \
  -H "Authorization: Bearer pv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/kimi-k2.5",
    "input": "A drone shot over a coastal city at sunset",
    "webhook_url": "https://example.com/webhooks/pipevideo"
  }'

The response includes an id and status: "queued". Save the id for polling or webhook correlation.

6. Get the result

Poll until the generation completes:

curl https://api.pipevideo.co/v1/responses/gen_abc123xyz \
  -H "Authorization: Bearer pv_your_api_key"

When status is completed, the video URL is in output_video_url.

Using the SDK

npm install pipevideo

import { PipevideoClient } from "pipevideo";

const pv = new PipevideoClient({ apiKey: process.env.PIPEVIDEO_API_KEY });

const response = await pv.responses.createAndWait({
  model: "moonshotai/kimi-k2.5",
  input: "Animated logo with pulsing circles",
});

console.log(response.output_video_url);

Next steps

• Video generation guide — full request parameters, status transitions, and error handling.
• Webhooks — pass webhook_url on create to receive completion events instead of polling.
• Provider routing — control which video orchestration provider fulfills your request.
• TypeScript SDK — typed client with create, get, wait, and createAndWait.