Create Re-translation

curl -X POST https://app.dubformer.ai/api/v1/projects/{project_id}/translations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_script": [
      {
        "start_ms": 100,
        "end_ms": 1544,
        "text": "Au revoir le monde!",
        "speaker_id": 1
      }
    ],
    "target_speakers": [
      {
        "speaker_id": 1,
        "voice_key": "53f154:fr-FR-DeniseNeural",
        "style": "feminine"
      }
    ],
    "mixing_mode": "voiceover_only"
  }'

import requests

url = 'https://app.dubformer.ai/api/v1/projects/{project_id}/translations'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
}
data = {
    "target_script": [
        {
            "start_ms": 100,
            "end_ms": 1544,
            "text": "Au revoir le monde!",
            "speaker_id": 1
        }
    ],
    "target_speakers": [
        {
            "speaker_id": 1,
            "voice_key": "53f154:fr-FR-DeniseNeural",
            "style": "feminine"
        }
    ],
    "mixing_mode": "voiceover_only"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const url = 'https://app.dubformer.ai/api/v1/projects/{project_id}/translations';
const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
};
const data = {
    target_script: [
        {
            start_ms: 100,
            end_ms: 1544,
            text: "Au revoir le monde!",
            speaker_id: 1
        }
    ],
    target_speakers: [
        {
            speaker_id: 1,
            voice_key: "53f154:fr-FR-DeniseNeural",
            style: "feminine"
        }
    ],
    mixing_mode: "voiceover_only"
};

fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify(data),
})
.then(response => response.json())
.then(data => console.log(data));

{
  "project_id": "12345",
  "cost_minutes": 0,
  "estimated_completion_date": "2024-06-05T12:00:00Z",
  "balance_minutes": 90,
  "translations_count": 1
}

POST

api

projects

{project_id}

translations

curl -X POST https://app.dubformer.ai/api/v1/projects/{project_id}/translations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_script": [
      {
        "start_ms": 100,
        "end_ms": 1544,
        "text": "Au revoir le monde!",
        "speaker_id": 1
      }
    ],
    "target_speakers": [
      {
        "speaker_id": 1,
        "voice_key": "53f154:fr-FR-DeniseNeural",
        "style": "feminine"
      }
    ],
    "mixing_mode": "voiceover_only"
  }'

import requests

url = 'https://app.dubformer.ai/api/v1/projects/{project_id}/translations'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
}
data = {
    "target_script": [
        {
            "start_ms": 100,
            "end_ms": 1544,
            "text": "Au revoir le monde!",
            "speaker_id": 1
        }
    ],
    "target_speakers": [
        {
            "speaker_id": 1,
            "voice_key": "53f154:fr-FR-DeniseNeural",
            "style": "feminine"
        }
    ],
    "mixing_mode": "voiceover_only"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const url = 'https://app.dubformer.ai/api/v1/projects/{project_id}/translations';
const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
};
const data = {
    target_script: [
        {
            start_ms: 100,
            end_ms: 1544,
            text: "Au revoir le monde!",
            speaker_id: 1
        }
    ],
    target_speakers: [
        {
            speaker_id: 1,
            voice_key: "53f154:fr-FR-DeniseNeural",
            style: "feminine"
        }
    ],
    mixing_mode: "voiceover_only"
};

fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify(data),
})
.then(response => response.json())
.then(data => console.log(data));

{
  "project_id": "12345",
  "cost_minutes": 0,
  "estimated_completion_date": "2024-06-05T12:00:00Z",
  "balance_minutes": 90,
  "translations_count": 1
}

Re-translation functionality is not available to all users by default. If you wish to use this feature, please contact us at support@dubformer.ai.

curl -X POST https://app.dubformer.ai/api/v1/projects/{project_id}/translations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_script": [
      {
        "start_ms": 100,
        "end_ms": 1544,
        "text": "Au revoir le monde!",
        "speaker_id": 1
      }
    ],
    "target_speakers": [
      {
        "speaker_id": 1,
        "voice_key": "53f154:fr-FR-DeniseNeural",
        "style": "feminine"
      }
    ],
    "mixing_mode": "voiceover_only"
  }'

import requests

url = 'https://app.dubformer.ai/api/v1/projects/{project_id}/translations'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
}
data = {
    "target_script": [
        {
            "start_ms": 100,
            "end_ms": 1544,
            "text": "Au revoir le monde!",
            "speaker_id": 1
        }
    ],
    "target_speakers": [
        {
            "speaker_id": 1,
            "voice_key": "53f154:fr-FR-DeniseNeural",
            "style": "feminine"
        }
    ],
    "mixing_mode": "voiceover_only"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const url = 'https://app.dubformer.ai/api/v1/projects/{project_id}/translations';
const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
};
const data = {
    target_script: [
        {
            start_ms: 100,
            end_ms: 1544,
            text: "Au revoir le monde!",
            speaker_id: 1
        }
    ],
    target_speakers: [
        {
            speaker_id: 1,
            voice_key: "53f154:fr-FR-DeniseNeural",
            style: "feminine"
        }
    ],
    mixing_mode: "voiceover_only"
};

fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify(data),
})
.then(response => response.json())
.then(data => console.log(data));

Path Parameters

project_id

string

required

The unique identifier of the project to re-translate.

Request Body

target_script

array

required

Array of target language script segments for dubbing.Timing and Speaker Behavior:

Speaker assignments are required - Each speaker_id must correspond to a speaker in target_speakers. If not specified, the request will be rejected with validation error
Timings may be modified - System adjusts timings to match synthesized speech length and avoid excessive speed changes, unless use_fixed_timings: true is set

Show Script Object Properties

start_ms

number

required

Start time in milliseconds.

end_ms

number

required

End time in milliseconds.

text

string

required

Text of the translation to synthesize.

speaker_id

number

required

Speaker ID corresponding to target_speakers.

target_speakers

array

required

Array of target speaker configurations for dubbing.

Show Speaker Object Properties

speaker_id

number

required

Unique speaker identifier (must match script speaker_id values).

style

string

required

Speaker style: masculine or feminine.

voice_key

string

required

Voice identifier. Can be:

soundalike for AI-generated voices matching original speakers
emotional_transfer for emotional soundalike voices
Specific voice key from Get Voices

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_fixed_timings

boolean

default:"false"

Whether to use fixed timings from the target script. By default, timings may be adjusted to fit the original video better.

tts_volume

string

default:"normal"

TTS volume level: very_quiet, quieter, normal, louder, very_loud.

Response

project_id

string

Unique identifier for the project.

cost_minutes

number

Number of minutes charged for this re-translation (typically 0).

estimated_completion_date

string

ISO timestamp of estimated completion time.

balance_minutes

number

Remaining balance in minutes.

translations_count

number

Total number of translations for this project.

{
  "project_id": "12345",
  "cost_minutes": 0,
  "estimated_completion_date": "2024-06-05T12:00:00Z",
  "balance_minutes": 90,
  "translations_count": 1
}

Getting Original Script Data

Use Get Project to retrieve the original output_source_script, output_target_script, and output_target_speakers as starting points for your re-translation.

Timing Considerations

start_ms and end_ms should align with natural speech boundaries
Large timing changes may affect lip-sync quality
Use use_fixed_timings: true to prevent automatic timing adjustments

Voice Selection

Use specific voice keys from Get Voices for consistent results
soundalike voices attempt to match original speaker characteristics
emotional_transfer provides more expression but may be less stable

Delete Project Validate Re-translation

Getting Started

Projects

Re-translations

Resources

Error Handling

Path Parameters

Request Body

Response

Getting Original Script Data

Timing Considerations

Voice Selection

​Path Parameters

​Request Body

​Response

​Getting Original Script Data

​Timing Considerations

​Voice Selection

Path Parameters

Request Body

Response

Getting Original Script Data

Timing Considerations

Voice Selection