Create Project

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
}

POST

api

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 track
voiceover_with_original_track - Voiceover with the original track
voiceover_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.

Pro subscription feature.

Timing and Speaker Behavior:

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 start_ms, end_ms, and text fields. Speakers will be determined automatically via biometrics.

Pro subscription feature.

Cannot be used together with 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
}

Getting Started

Projects

Re-translations

Resources

Error Handling

Request Body

Response

​Request Body

​Response

Request Body

Response