v1

latestOpenAPI 3.1.02026-07-2671117149.2 KB
Apis
Project Setup

Create Project

post/project-setup

Request body

project_namestring nullable

Enter a distinctive name for your project that reflects its purpose or content. This name will be displayed in your CAMB.AI workspace dashboard and used to organize related assets, transcriptions, etc.. . Choose something memorable that helps you quickly identify this specific project among your other voice, audio and localization tasks.

project_descriptionstring nullable

Provide details about your project's goals and specifications. Include information such as the target languages for translation or dubbing, desired voice characteristics, emotional tones to capture, or specific audio processing requirements, outlining the workflow here can serve as valuable documentation for organizational purposes.

media_urlstring uri required

The source location of your media content. This URI can point to YouTube videos, Google Drive files, or direct media file URLs. The system validates accessibility and begins media analysis immediately upon receipt. Think of this as telling the system where to find your raw material for processing

source_languagestring required
target_languagesLanguageInput[] required

Languages to generate output in. Pass locale tags (es-es, fr-fr, de-de). Numeric language IDs still work but are deprecated. See all target languages.

selected_audio_tracksinteger[] nullable

Optional array of one or two zero‑based audio track indices to dub. Only supported for MXF files. If omitted, the first audio track (index 0) is used by default.

add_output_as_an_audio_trackboolean nullable

Optional flag to append the dubbed audio as a new audio track in the output file. Only supported for MXF files. If true, the dubbed audio is added as an additional track; if false or omitted, the source would be returned with only dubbed audio.

chosen_dictionariesinteger[] nullable

An optional list of dictionary IDs selected by the user. Each entry must be an integer corresponding to a valid dictionary ID. If provided, at least one ID is required.

folder_idinteger nullable

Specify the organizational folder within your CAMB.AI workspace where this task should be created and stored. The folder must already exist in your workspace and be accessible through your current API key authentication. This helps maintain project organization by grouping related tasks together, making it easier to manage and locate your projects.

Example request

{
  "target_languages": [
    "es-es",
    "fr-fr"
  ]
}

Response

Successful Response

task_idstring