List Project Videos

Retrieve a list of all videos associated with a specific project

GET /api/v1/projects/{projectId}/videos

cURL

curl -X GET \
  https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos \
  -H 'Authorization: Bearer YOUR_API_KEY'

import axios from 'axios';

const response = await axios.get(
  'https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

console.log(response.data);

Response

[
  {
    "id": "7a92c36d4fe3c8b1234567891",
    "name": "marketing_video_1.mp4",
    "status": "completed",
    "processingType": "dubbing",
    "srcLang": "en",
    "dstLangs": ["es-ES", "fr-FR"],
    "videoUrl": "https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos/7a92c36d4fe3c8b1234567891",
    "videoDuration": 123.45,
    "remark": "Some remark",
    "stringVariables": [
      { "key": "storyTitleId", "value": "12345" }
    ],
    "createdAt": "2023-12-01T10:30:00.000Z",
    "updatedAt": "2023-12-01T15:45:00.000Z"
  },
  {
    "id": "8b03d47e5gf4d9c1234567892",
    "name": "training_video_2.mp4",
    "status": "in_progress",
    "processingType": "voiceover",
    "srcLang": "en",
    "dstLangs": ["es-ES"],
    "videoUrl": "https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos/8b03d47e5gf4d9c1234567892",
    "videoDuration": 98.7,
    "remark": null,
    "stringVariables": null,
    "createdAt": "2023-12-01T11:00:00.000Z",
    "updatedAt": "2023-12-01T14:20:00.000Z"
  }
]

This endpoint returns a list of all videos that were added to the specified project.

Path Parameters

projectId · string · required

The unique identifier of the project.

Response

The response is a JSON array of video objects. Each object has the following fields:

id · string

Unique video identifier.

name · string

Name of the video.

status · string

Current status of the video (e.g., new, in_progress, completed).

processingType · string

Type of video processing (e.g., dubbing, voiceover, audio_description, transcription, translation, subtitling).

srcLang · string

Source language code.

dstLangs · array

Array of target language codes.

videoUrl · string

URL to the video resource.

videoDuration · number

Duration of the video in seconds (if available).

remark · string

Additional remarks about the video (if any).

stringVariables · array | null

Array of key-value pairs containing video metadata, if provided.

createdAt · string

ISO timestamp of creation.

updatedAt · string

ISO timestamp of last update.

cURL

curl -X GET \
  https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos \
  -H 'Authorization: Bearer YOUR_API_KEY'

import axios from 'axios';

const response = await axios.get(
  'https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

console.log(response.data);

Response

[
  {
    "id": "7a92c36d4fe3c8b1234567891",
    "name": "marketing_video_1.mp4",
    "status": "completed",
    "processingType": "dubbing",
    "srcLang": "en",
    "dstLangs": ["es-ES", "fr-FR"],
    "videoUrl": "https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos/7a92c36d4fe3c8b1234567891",
    "videoDuration": 123.45,
    "remark": "Some remark",
    "stringVariables": [
      { "key": "storyTitleId", "value": "12345" }
    ],
    "createdAt": "2023-12-01T10:30:00.000Z",
    "updatedAt": "2023-12-01T15:45:00.000Z"
  },
  {
    "id": "8b03d47e5gf4d9c1234567892",
    "name": "training_video_2.mp4",
    "status": "in_progress",
    "processingType": "voiceover",
    "srcLang": "en",
    "dstLangs": ["es-ES"],
    "videoUrl": "https://studio.dubformer.ai/api/v1/projects/5f83a14b2ec1b8a1234567890/videos/8b03d47e5gf4d9c1234567892",
    "videoDuration": 98.7,
    "remark": null,
    "stringVariables": null,
    "createdAt": "2023-12-01T11:00:00.000Z",
    "updatedAt": "2023-12-01T14:20:00.000Z"
  }
]

Error Response

{
  "error": "Not Found"
}