VideoGen API

import { VideoGen } from "@videogen/sdk";
const client = new VideoGen({ apiKey: "sk_videogen_live_..." });
await client.projects.listProjectExports({
  projectId: "vg_proj_9dTk3mQ1rZ7xP4vN2sB6wc",
});

{
  "exports": [
    {
      "exportId": "vg_expo_4bHn8pR2sY5xM1vL3tC7wd",
      "projectId": "vg_proj_9dTk3mQ1rZ7xP4vN2sB6wc",
      "status": "succeeded",
      "progressPercentage": 100,
      "attemptIndex": 0,
      "downloadUrl": "https://stream.media.videogen.io/example/1080p.mp4?token=abc&download=Staying%20hydrated.mp4",
      "downloadUrlExpiresAt": 1748001600,
      "thumbnailUrl": "https://image.media.videogen.io/example/thumbnail.jpg?token=abc",
      "thumbnailUrlExpiresAt": 1748001600,
      "exportFileId": "vg_file_obLD1OX2eJCrEs0071Z4kA",
      "file": {
        "fileId": "vg_file_obLD1OX2eJCrEs0071Z4kA",
        "scope": "EXPORT",
        "type": "VIDEO",
        "displayName": "Staying hydrated",
        "durationSeconds": 12.5,
        "downloadUrl": "https://stream.media.videogen.io/example/1080p.mp4?token=abc&download=Staying%20hydrated.mp4",
        "downloadUrlExpiresAt": 1748001600,
        "thumbnailUrl": "https://image.media.videogen.io/example/thumbnail.jpg?token=abc",
        "thumbnailUrlExpiresAt": 1748001600,
        "thumbnailSource": {
          "status": "ready",
          "url": "https://image.media.videogen.io/example/thumbnail.jpg?token=abc",
          "expiresAt": 1748001600,
          "width": 426,
          "height": 240
        },
        "downloadSource": {
          "status": "ready",
          "url": "https://stream.media.videogen.io/example/1080p.mp4?token=abc&download=Staying%20hydrated.mp4",
          "expiresAt": 1748001600,
          "width": 1920,
          "height": 1080
        },
        "isPublicPreviewEnabled": false
      },
      "error": null
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Returns a project’s exports, newest first, as fully hydrated ProjectExport objects (status, signed download/thumbnail URLs, and the embedded file). Signed URLs are re-signed when within an hour of expiring, so they are always valid long enough to use. Cursor-paginated; see the Pagination guide.

Authentication

AuthorizationBearer

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

API key from [app.videogen.io/developers](https://app.videogen.io/developers). The full key is only shown once when you create it.

Path parameters

projectIdstringRequired

The project id (e.g. vg_proj_...).

Query parameters

limitintegerOptional1-200Defaults to 50

Maximum number of items to return in the page. Defaults to 50; capped at 200. See Pagination.

cursorstringOptional

Opaque pagination cursor returned as nextCursor by the previous page. Omit on the first request. Cursors are tied to the endpoint that produced them and must be passed unmodified. See Pagination.

Response

Project exports.

exportslist of objects

Fully hydrated exports for this project, newest first. Each includes status, signed download/thumbnail URLs, and the embedded file.

hasMoreboolean

When true, there are more exports available. Pass nextCursor as the cursor query param to fetch the next page.

nextCursorstring or null

Opaque cursor to fetch the next page. null when hasMore is false.