POST
/
api
/
v1
/
projects
/
{projectId}
/
videos
/
create
curl -X POST \
  https://studio.dubformer.ai/api/v1/projects/proj_5f83a14b2ec1b/videos/create \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "New Marketing Video",
    "workflowType": "dubbing",
    "originalVideoArtifactId": "artifact_1234567890",
    "sourceLanguage": "en",
    "targetLanguages": ["es-ES", "fr-FR"],
    "pipelineOptions": {
      "shouldAutomateTranscription": true,
      "shouldAutomateTranslation": true,
      "shouldAutomateVoiceSelection": false
    },
    "remark": "Optional comment"
  }'

{
  "id": "vid_7a92c36d4fe3c",
  "videoUrl": "https://studio.dubformer.ai/api/v1/projects/proj_5f83a14b2ec1b/videos/vid_7a92c36d4fe3c",
  "name": "New Marketing Video",
  "status": "new",
  "workflowType": "dubbing",
  "srcLang": "en",
  "dstLangs": ["es-ES", "fr-FR"],
  "videoDuration": 123.45,
  "remark": "Optional comment",
  "createdAt": "2024-06-30T12:00:00.000Z",
  "updatedAt": "2024-06-30T12:00:00.000Z"
}
This endpoint allows you to add a new video to an existing project. The video will be uploaded to the pipeline for processing.

​
Path Parameters

​
projectId
string
required
The unique identifier of the project.

​
Request Body

​
name
string
required
Name of the video.
​
workflowType
string
required
Type of video processing (e.g., ‘dubbing’, ‘voiceover’, ‘audio_description’).
​
originalVideoArtifactId
string
required
Artifact ID of the original video (must be uploaded beforehand).
​
sourceLanguage
string
required
Source language code (e.g., ‘en’, ‘ru’).
​
targetLanguages
array
required
Array of target language codes (e.g., [‘es-ES’, ‘fr-FR’]).
​
backgroundWavArtifactId
string
Artifact ID of the background audio (optional).
​
internationalMixWavArtifactId
string
Artifact ID of the international mix audio (optional).
​
vocalsHitlWavArtifactId
string
Artifact ID of the vocals HITL audio (optional).
​
remark
string
Additional remarks about the video (optional).
​
pipelineOptions
object
Pipeline configuration options (see below, all fields optional):
  • shouldAutomateTranscription: boolean
  • shouldAutomateTranslation: boolean
  • shouldAutomateVoiceSelection: boolean
If you automate transcription, you won’t be able to edit the generated transcription in the future. The transcription phase will be skipped, and the result of the AI’s work will be used.
curl -X POST \
  https://studio.dubformer.ai/api/v1/projects/proj_5f83a14b2ec1b/videos/create \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "New Marketing Video",
    "workflowType": "dubbing",
    "originalVideoArtifactId": "artifact_1234567890",
    "sourceLanguage": "en",
    "targetLanguages": ["es-ES", "fr-FR"],
    "pipelineOptions": {
      "shouldAutomateTranscription": true,
      "shouldAutomateTranslation": true,
      "shouldAutomateVoiceSelection": false
    },
    "remark": "Optional comment"
  }'

​
Response

​
id
string
Unique identifier of the created video.
​
videoUrl
string
URL to the created video resource.
​
name
string
Name of the video.
​
status
string
Status of the video (e.g., ‘new’).
​
workflowType
string
Type of the video processing (e.g., ‘dubbing’).
​
srcLang
string
Source language code.
​
dstLangs
array
Array of target language codes.
​
videoDuration
number
Duration of the video in seconds (if available).
​
remark
string
Additional remarks about the video (if any).
​
createdAt
string
ISO timestamp of creation.
​
updatedAt
string
ISO timestamp of last update.
{
  "id": "vid_7a92c36d4fe3c",
  "videoUrl": "https://studio.dubformer.ai/api/v1/projects/proj_5f83a14b2ec1b/videos/vid_7a92c36d4fe3c",
  "name": "New Marketing Video",
  "status": "new",
  "workflowType": "dubbing",
  "srcLang": "en",
  "dstLangs": ["es-ES", "fr-FR"],
  "videoDuration": 123.45,
  "remark": "Optional comment",
  "createdAt": "2024-06-30T12:00:00.000Z",
  "updatedAt": "2024-06-30T12:00:00.000Z"
}

{
  "error": "Bad Request"
}