Skip to main content
The Vidgen API is the HTTP interface for the Vidgen video and image generation engine. With one API key you can create jobs, send reference images or video, and fetch the finished result — without opening the dashboard.

Quickstart

Send your first request in 3 minutes.

Authentication

How to use Authorization: Bearer and x-api-key.

API reference

Every endpoint, parameter, and response shape.

Usage limits

Concurrency, daily quotas, and job lifetime.

​
How it works

The Vidgen API is asynchronous. A POST /api/v1/generate request is answered immediately with 202 Accepted containing job.id, and you then fetch the result with GET /api/v1/jobs/{id} until the status is succeeded.
1

Send a prompt + model

Pick a model from the catalog (for example seedance-2-5-flash), write your prompt, and set duration/ratio/resolution in parameters.
2

The server queues the job

Credits are deducted up front, the job enters the queue, and you receive job.id along with your queue position.
3

Poll until it finishes

Check the status every 5 seconds. While the status is queued you see queuePosition; when it is succeeded you get the media URL.
4

Download the result

Store the URL in your own storage. Result links have a limited lifetime, so do not rely on them as a permanent source.

​
Get started in 3 steps

1

Create an API key

Sign in at vidgen.id → Documentation, click Create API Key, and copy the value. Keys are formatted vg_... and are shown only once.
2

Send your first request

create curl
3

Fetch the result

poll curl

​
Browse the documentation

Model catalog

Active models, their capabilities, and how to read them at runtime.

Credits & pricing

How billing is calculated and when the Unlimited package charges 0 credits.

Reference media

Size, duration, and resolution limits for reference files.

Idempotency

Avoid being billed twice when you retry.

Node.js

A complete client with no extra dependencies.

Python

The generate() and wait_for_job() helpers.
Need help? Send a support message through the Vidgen dashboard, or read the error codes first.