curl -X POST https://app.dubformer.ai/api/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Project",
"source_lang": "en",
"target_lang": "fr-FR",
"source_video_url": "https://example.com/video.mp4",
"use_soundalike_voices": true,
"mixing_mode": "voiceover_with_original_track"
}'
import requests
url = 'https://app.dubformer.ai/api/v1/projects'
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
data = {
"name": "My Project",
"source_lang": "en",
"target_lang": "fr-FR",
"source_video_url": "https://example.com/video.mp4",
"use_soundalike_voices": True,
"mixing_mode": "voiceover_with_original_track"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = 'https://app.dubformer.ai/api/v1/projects';
const headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
};
const data = {
name: "My Project",
source_lang: "en",
target_lang: "fr-FR",
source_video_url: "https://example.com/video.mp4",
use_soundalike_voices: true,
mixing_mode: "voiceover_with_original_track"
};
fetch(url, {
method: 'POST',
headers,
body: JSON.stringify(data),
})
.then(response => response.json())
.then(data => console.log(data));
{
"project_id": "12345",
"cost_minutes": 10,
"estimated_completion_date": "2024-06-05T12:00:00Z",
"balance_minutes": 90,
"translations_count": 0
}
Projects
Create Project
Create a new dubbing project
POST
/
api
/
v1
/
projects
curl -X POST https://app.dubformer.ai/api/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Project",
"source_lang": "en",
"target_lang": "fr-FR",
"source_video_url": "https://example.com/video.mp4",
"use_soundalike_voices": true,
"mixing_mode": "voiceover_with_original_track"
}'
import requests
url = 'https://app.dubformer.ai/api/v1/projects'
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
data = {
"name": "My Project",
"source_lang": "en",
"target_lang": "fr-FR",
"source_video_url": "https://example.com/video.mp4",
"use_soundalike_voices": True,
"mixing_mode": "voiceover_with_original_track"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = 'https://app.dubformer.ai/api/v1/projects';
const headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
};
const data = {
name: "My Project",
source_lang: "en",
target_lang: "fr-FR",
source_video_url: "https://example.com/video.mp4",
use_soundalike_voices: true,
mixing_mode: "voiceover_with_original_track"
};
fetch(url, {
method: 'POST',
headers,
body: JSON.stringify(data),
})
.then(response => response.json())
.then(data => console.log(data));
{
"project_id": "12345",
"cost_minutes": 10,
"estimated_completion_date": "2024-06-05T12:00:00Z",
"balance_minutes": 90,
"translations_count": 0
}
curl -X POST https://app.dubformer.ai/api/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My Project",
"source_lang": "en",
"target_lang": "fr-FR",
"source_video_url": "https://example.com/video.mp4",
"use_soundalike_voices": true,
"mixing_mode": "voiceover_with_original_track"
}'
import requests
url = 'https://app.dubformer.ai/api/v1/projects'
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
data = {
"name": "My Project",
"source_lang": "en",
"target_lang": "fr-FR",
"source_video_url": "https://example.com/video.mp4",
"use_soundalike_voices": True,
"mixing_mode": "voiceover_with_original_track"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = 'https://app.dubformer.ai/api/v1/projects';
const headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
};
const data = {
name: "My Project",
source_lang: "en",
target_lang: "fr-FR",
source_video_url: "https://example.com/video.mp4",
use_soundalike_voices: true,
mixing_mode: "voiceover_with_original_track"
};
fetch(url, {
method: 'POST',
headers,
body: JSON.stringify(data),
})
.then(response => response.json())
.then(data => console.log(data));
Request Body
string
The name of the project for organization purposes.
string
required
The source language of the video without locale (e.g., “en”, “es”, “fr”).
Get the full list from Get Options.
string
required
The target language for dubbing with locale (e.g., “en-US”, “fr-FR”, “es-ES”).
Get the full list from Get Options.
string
required
Direct link to the source video file or YouTube URL.
string
default:"voiceover_with_original_track"
Audio mixing mode:
voiceover_only- Only voiceover without the original trackvoiceover_with_original_track- Voiceover with the original trackvoiceover_without_original_voice- Smart vocal removal dubbing
boolean
default:"false"
Enable emotional but less stable soundalike voices.
Supports only English, Spanish, French, German, Italian, and Portuguese target languages.
boolean
default:"false"
Enable soundalike voices that match original speaker characteristics.
Requires an active subscription.
string
Custom transcription of the source video in SRT, VTT, or plain text format.
Timing and Speaker Behavior:
Pro subscription feature.
- Timings are NOT preserved - Original timings are ignored and recalculated based on speech boundaries in audio for precise alignment
- Speaker markup is NOT preserved - Speaker tags (e.g.,
<v Speaker1>,<v John>) are ignored and not extracted as speaker information
array
Structured source script with precise timings. Array of objects with Cannot be used together with
start_ms, end_ms, and text fields.
Speakers will be determined automatically via biometrics.
Pro subscription feature.
source_script_content.Example:[
{ "start_ms": 0, "end_ms": 2000, "text": "Hello world" },
{ "start_ms": 2500, "end_ms": 5000, "text": "How are you?" }
]
boolean
default:"false"
When
true, source timings from source_script will be preserved (no alignment or rechunking).
Useful when providing pre-translated scripts with source_lang = target_lang.string
Translation glossary in TSV format to ensure consistent terminology.
Pro subscription feature.
string
default:"normal"
TTS volume level. Options:
very_quiet, quieter, normal, louder, very_loud.Response
string
Unique identifier for the created project.
number
Number of minutes charged for this project.
string
ISO timestamp of estimated completion time.
number
Remaining balance in minutes after this project.
number
Number of translations created (always 0 for new projects).
{
"project_id": "12345",
"cost_minutes": 10,
"estimated_completion_date": "2024-06-05T12:00:00Z",
"balance_minutes": 90,
"translations_count": 0
}