Nhà phát triển API

Video Dubbing

Full video dubbing: send a video URL + target languages, get localized videos back.

Request body

Response

ConsentAttestation

speaker_consent_obtained	boolean | null	Attests that explicit consent has been obtained from all identifiable speakers. Required for voice_matched mode only.
content_rights_confirmed	boolean	Attests ownership or a valid license to the content. Required in both modes.
eula_accepted	boolean	Confirms the client has read and accepts the Addavox EULA. Required in both modes.
attested_by	string	Email or identifier of the responsible individual or system.
attested_at	string	ISO 8601 timestamp of attestation. Must be within 24 hours of the request.

Voice Separation

Split caller-supplied audio into vocals + background stems (async job).

Request body

Response

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Transcribe

Transcribe caller-supplied audio and return a transcript (async job).

Request body

Response

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Pro Transcription

Separate, then transcribe the isolated vocals stem — a cleaner transcript (async job).

Request body

Response

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Translate

Machine-translate text from one language to another. Returns the translated text synchronously — no audio, no job to poll.

Request body

Response

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Example

curl -X POST https://api.addavox.com/api/v1/translate \
      -H "X-API-Key: $ADDAVOX_KEY" -H "Content-Type: application/json" \
      -d '{"text": "Hello", "target_language": "es"}'

Narrate

Narrate already-translated text into an audiobook, in a preset voice you choose. Preset (synth) voices only — no voice matching.

Request body

Response

ExternalSegment

source_text	string	Original text for this segment.
start_time	number	Segment start, in seconds. Used for speaker-voice matching only, not output timing.
end_time	number	Segment end, in seconds. Used for speaker-voice matching only, not output timing.
words	object[]	Word-level timing; defaults to empty.
speaker	object | null	Speaker metadata for voice selection.
translated_text	string | null	Pre-supplied translation. If provided, translation is skipped for this segment.

ConsentAttestation

speaker_consent_obtained	boolean | null	Attests that explicit consent has been obtained from all identifiable speakers. Required for voice_matched mode only.
content_rights_confirmed	boolean	Attests ownership or a valid license to the content. Required in both modes.
eula_accepted	boolean	Confirms the client has read and accepts the Addavox EULA. Required in both modes.
attested_by	string	Email or identifier of the responsible individual or system.
attested_at	string	ISO 8601 timestamp of attestation. Must be within 24 hours of the request.

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Translate + Narrate — preset voice

Translate your text to the target language and narrate it in a preset voice. Source and target language must differ.

Request body

Response

ExternalSegment

source_text	string	Original text for this segment.
start_time	number	Segment start, in seconds. Used for speaker-voice matching only, not output timing.
end_time	number	Segment end, in seconds. Used for speaker-voice matching only, not output timing.
words	object[]	Word-level timing; defaults to empty.
speaker	object | null	Speaker metadata for voice selection.
translated_text	string | null	Pre-supplied translation. If provided, translation is skipped for this segment.

ConsentAttestation

speaker_consent_obtained	boolean | null	Attests that explicit consent has been obtained from all identifiable speakers. Required for voice_matched mode only.
content_rights_confirmed	boolean	Attests ownership or a valid license to the content. Required in both modes.
eula_accepted	boolean	Confirms the client has read and accepts the Addavox EULA. Required in both modes.
attested_by	string	Email or identifier of the responsible individual or system.
attested_at	string	ISO 8601 timestamp of attestation. Must be within 24 hours of the request.

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Translate + Narrate — matched voice

Translate your text to the target language and narrate it in a voice matched from an audio sample you provide. There is no minimum length; samples of about 3–5 seconds or more work best. Source and target language must differ.

Request body

Response

ExternalSegment

source_text	string	Original text for this segment.
start_time	number	Segment start, in seconds. Used for speaker-voice matching only, not output timing.
end_time	number	Segment end, in seconds. Used for speaker-voice matching only, not output timing.
words	object[]	Word-level timing; defaults to empty.
speaker	object | null	Speaker metadata for voice selection.
translated_text	string | null	Pre-supplied translation. If provided, translation is skipped for this segment.

ConsentAttestation

speaker_consent_obtained	boolean | null	Attests that explicit consent has been obtained from all identifiable speakers. Required for voice_matched mode only.
content_rights_confirmed	boolean	Attests ownership or a valid license to the content. Required in both modes.
eula_accepted	boolean	Confirms the client has read and accepts the Addavox EULA. Required in both modes.
attested_by	string	Email or identifier of the responsible individual or system.
attested_at	string	ISO 8601 timestamp of attestation. Must be within 24 hours of the request.

ChargeInfo

amount	number	Total amount charged for this submission, in USD.
rate_per_min	number	Per-minute rate applied.
duration_min	number	Billed minutes (for text services, characters/1000).
num_languages	integer	Number of target languages billed.
credit_balance_after	number	Account credit balance after the charge, in USD.

Job Status

Check the status of an external localization job.

Response

Job Result

Get the download URL for a completed external localization job.

Response

VideoJobResultLanguage

language	string	Target language code for this result.
video_url	string | null	Signed URL of the dubbed video (24h expiry).
audio_url	string | null	Signed URL of the dubbed audio track (24h expiry).
subtitle_url	string | null	Signed URL of the subtitle file (24h expiry).

Cancel Job

Cancel a queued or running job and refund the charge to the account balance.

Response

List Jobs

List localization jobs for the authenticated account. Query params: status — filter by queued | running | completed | failed | cancelled limit — max results (default 20, max 100) offset — pagination offset (default 0)

Response

JobListItem

job_id	string	Job ID.
project_id	string	Project the job belongs to.
type	string	Job type.
target_language	string | null	Target language code, if applicable.
status	string	queued | running | completed | failed | cancelled.
total_segments	integer	Total segment count.
completed_segments	integer	Completed segment count.
error	string | null	Failure message when the job failed.
created_at	string | null	ISO 8601 creation time.
started_at	string | null	ISO 8601 start time, if started.
completed_at	string | null	ISO 8601 completion time, if finished.
charge	JobListCharge | null	Charge summary, present if the job was billed.

Webhook Log

Return the webhook delivery log for a job (all attempts, newest first).

Response

WebhookDelivery

id	string | null	Delivery attempt ID.
event	string | null	Event type delivered, e.g. 'job.completed'.
attempt	integer | null	Attempt number for this event.
status_code	integer | null	HTTP status returned by the endpoint, if any.
error	string | null	Delivery error, if the attempt failed.
delivered_at	string | null	ISO 8601 time of the attempt.

Retry Webhook

Re-trigger webhook delivery for the most recent event on a job.

Response

Account

Return credit balance and current plan for the authenticated account.

Response

List Voices

Return available voices for a given language code. Query params: language — BCP-47 code, e.g. 'en-US', 'es-ES' (required) gender — optional filter: MALE | FEMALE

List Languages

Return supported languages. Query params: detail — if true, include provider metadata per language

Invite Reviewer

Invite a reviewer to a project (API endpoint).

Request body

Response