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"
  }'

{
  "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"
  }'

​
Request Body

​
name
string
The name of the project for organization purposes.
​
source_lang
string
required
The source language of the video without locale (e.g., “en”, “es”, “fr”). Get the full list from Get Options.
​
target_lang
string
required
The target language for dubbing with locale (e.g., “en-US”, “fr-FR”, “es-ES”). Get the full list from Get Options.
​
source_video_url
string
required
Direct link to the source video file or YouTube URL.
​
mixing_mode
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
​
use_emotional_transfer
boolean
default:"false"
Enable emotional but less stable soundalike voices.
Supports only English, Spanish, French, German, Italian, and Portuguese target languages.
​
use_soundalike_voices
boolean
default:"false"
Enable soundalike voices that match original speaker characteristics.
Requires an active subscription.
​
source_script_content
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
​
glossary_content
string
Translation glossary in TSV format to ensure consistent terminology.
Pro subscription feature.
​
tts_volume
string
default:"normal"
TTS volume level. Options: very_quiet, quieter, normal, louder, very_loud.

​
Response

​
project_id
string
Unique identifier for the created project.
​
cost_minutes
number
Number of minutes charged for this project.
​
estimated_completion_date
string
ISO timestamp of estimated completion time.
​
balance_minutes
number
Remaining balance in minutes after this project.
​
translations_count
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
}