Skip to main content
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",
    "sourceArtifactId": "artifact_1234567890",
    "sourceLanguage": "en",
    "targetLanguages": ["es-ES", "fr-FR"],
    "pipelineOptions": {
      "shouldAutomateTranscription": true,
      "shouldAutomateTranslation": true,
      "shouldAutomateVoiceSelection": false
    },
    "remark": "Optional comment",
    "stringVariables": [
      { "key": "storyTitleId", "value": "12345" },
      { "key": "storyDeeplink", "value": "https://pyramid.dalet.euronews.tech?titleId=12345&kanbanViewId=7KV6cv" }
    ]
  }'

{
  "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",
  "stringVariables": [
    { "key": "storyTitleId", "value": "12345" },
    { "key": "storyDeeplink", "value": "https://pyramid.dalet.euronews.tech?titleId=12345&kanbanViewId=7KV6cv" }
  ],
  "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, transcription, translation, subtitling).
​
sourceArtifactId
string
required
Artifact ID of the source 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).
​
stringVariables
array
Optional array of key-value pairs for storing video metadata. Useful for storing external system references like backlinks, identifiers, or other custom metadata.Each item should be an object with key and value properties (both strings).Example:
[
  { "key": "storyTitleId", "value": "12345" },
  { "key": "storyDeeplink", "value": "https://..." }
]
​
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",
    "sourceArtifactId": "artifact_1234567890",
    "sourceLanguage": "en",
    "targetLanguages": ["es-ES", "fr-FR"],
    "pipelineOptions": {
      "shouldAutomateTranscription": true,
      "shouldAutomateTranslation": true,
      "shouldAutomateVoiceSelection": false
    },
    "remark": "Optional comment",
    "stringVariables": [
      { "key": "storyTitleId", "value": "12345" },
      { "key": "storyDeeplink", "value": "https://pyramid.dalet.euronews.tech?titleId=12345&kanbanViewId=7KV6cv" }
    ]
  }'

​
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).
​
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.
{
  "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",
  "stringVariables": [
    { "key": "storyTitleId", "value": "12345" },
    { "key": "storyDeeplink", "value": "https://pyramid.dalet.euronews.tech?titleId=12345&kanbanViewId=7KV6cv" }
  ],
  "createdAt": "2024-06-30T12:00:00.000Z",
  "updatedAt": "2024-06-30T12:00:00.000Z"
}

{
  "error": "Bad Request"
}