VideoGen API

import { VideoGenClient } from "@videogen/sdk";
const client = new VideoGenClient({ token: "YOUR_TOKEN" });
await client.files.searchFiles({
    query: "query"
});

{
  "results": [
    {
      "similarity": 0.82,
      "file": {
        "fileId": "string",
        "scope": "GLOBAL",
        "type": "IMAGE",
        "displayName": "string",
        "description": "string",
        "durationSeconds": 1.1,
        "transcript": "string",
        "thumbnailSource": {
          "status": "pending",
          "url": "string",
          "expiresAt": 1.1,
          "width": 1,
          "height": 1,
          "fileBytes": 1
        },
        "previewSource": {
          "status": "pending",
          "url": "string",
          "expiresAt": 1.1,
          "width": 1,
          "height": 1,
          "fileBytes": 1
        },
        "downloadSource": {
          "status": "pending",
          "url": "string",
          "expiresAt": 1.1,
          "width": 1,
          "height": 1,
          "fileBytes": 1
        },
        "hlsSource": {
          "status": "pending",
          "url": "string",
          "expiresAt": 1.1,
          "width": 1,
          "height": 1,
          "fileBytes": 1
        },
        "isPublicPreviewEnabled": true,
        "publicHlsUrl": "string",
        "publicPlaybackId": "string",
        "sourceToolType": "string",
        "sourceToolExecutionId": "string"
      }
    }
  ]
}

Semantic vector search over your files. Embeds the query text and returns the closest matching files ranked by cosine similarity. Only files with indexed descriptions are searchable.

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.

Request

This endpoint expects an object.

querystringRequired

Natural-language search query. The text is embedded and compared against file description vectors using cosine similarity.

numResultsintegerOptional1-100Defaults to 10

Number of results to return (1–100). Defaults to 10.

selfOnlybooleanOptionalDefaults to false

When true, only files created by the calling API key’s user are returned. When false (default), all files accessible to the team are included.

Response

Search results ordered by descending similarity

resultslist of objects