REST API Reference

REST API overview

Base URL, authentication, and conventions for the VideoGen REST API.

Base URL

https://api.videogen.io

Authentication

All requests require a bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from app.videogen.io/developers. The full key is only shown once when you create it.

Request format

  • All request bodies are JSON (Content-Type: application/json).
  • All tool endpoints are asynchronous: POST /v1/tools/... returns 202 Accepted with a toolExecutionId.
  • Poll GET /v1/tools/executions/{toolExecutionId} until status is succeeded, failed, or cancelled, or subscribe to webhooks.

IDs

All IDs are prefixed strings (e.g. vg_exec_..., vg_file_...). Store them as-is and do not parse them.