Documentation

Changelog

Changes that affect API integrations, newest first. See the release history for the full list of portal changes.

2026-10-12v1.0.17
AddedDubbing API

New TTS models LINNET_4 (1 credit per second) and FINCH (0.2 credits per second, resolution multiplier applies; Pro plan and above, otherwise 403 VT40314). Supported languages are listed per language in supportedTtsModels. LINNET_4 is now the default when ttsModel is omitted (previously ORIOLE); languages that do not support LINNET_4 still default to ORIOLE.

Send ttsModel explicitly if you rely on ORIOLE; omitted ttsModel now resolves to LINNET_4 where the language supports it.

View reference
2026-10-12v1.0.17
ChangedDubbing API

TTS model DODO renamed to LINNET_3. Responses (supportedTtsModels, project ttsModel) return LINNET_3; requests still accept DODO and ELEVEN_V3 as deprecated aliases.

Compare against LINNET_3 when reading responses. Send LINNET_3 in requests.

View reference
2026-09-29v1.0.16
ChangedDubbing API

TTS models renamed: AUDIO_ENGINE_V3 → ORIOLE, ELEVEN_V2 → WREN, ELEVEN_V3 → DODO. Responses (supportedTtsModels, project ttsModel) return the new names; requests still accept the old names.

Compare against the new names when reading responses. Send the new names in requests.

View reference
2026-09-29v1.0.16
AddedDubbing API

NIGHTINGALE TTS model (end-to-end dubbing with cloned voices, 6 credits per second) with targetLanguages[].cloningStrength. Estimate Quota Usage gains translateType, ttsModelCounts, projectSeq and exportCount.

View reference
2026-09-16v1.0.15
AddedEditing API

Bulk Change Speakers endpoint (POST .../speakers/bulk-change) moves every script of one speaker to another in a single call.

View reference
2026-09-16v1.0.15
ChangedDubbing API

Request examples now use AUDIO_ENGINE_V3 as the recommended ttsModel (Expressive, supported by all languages). ttsModel and supportedTtsModels now show a description per value.

View reference
2026-08-10v1.0.14
ChangedFile API

Validate Media minimum media duration corrected from 5 seconds to 1 second (error F4009).

View reference
2026-07-23v1.0.13
AddedEditing API

Add Speaker from Sentence endpoint (POST .../speakers/from-sentence) clones a voice from a reference sentence and adds it as a new speaker.

View reference
2026-07-21v1.0.12
ChangedDubbing API

ttsModel must be one of the target language's supportedTtsModels, otherwise 400 VT4009. AUDIO_ENGINE_V3 added to the ttsModel values; supportedTtsModels and languageTag documented on the Language API.

View reference
2026-07-21v1.0.12
ChangedGeneral

Error formats documented as actually returned: gateway G0001/A0010, domain code/detailCode, and RFC 7807 parameter errors. 14 response specs aligned with production (creation status 200, projectSpeakerSeq, relative /perso-storage/... paths).

View reference
2026-07-21v1.0.12
AddedGeneral

/connect page lets the perso-dubbing plugin obtain an API key in one click.

View reference
2026-06-18v1.0.9
ChangedGeneral

Response examples no longer show a result wrapper; they match the top-level shape the API returns.

View reference
2026-06-18v1.0.9
ChangedFile API

Download target values realigned: video, originalSubtitle, translatedSubtitle removed; audioScript, scriptTimestamps, originalSubBackground added. media_type values are lowercase (video, audio). File register step is PUT.

View reference
2026-05-20v1.0.8
DeprecatedDubbing API

Translate request fields targetLanguageCodes and top-level ttsModel (deprecated since 2026-05-14).

Use targetLanguages with a per-language ttsModel.

View reference
2026-04-28
AddedGeneral

Initial public release of the Perso AI API documentation.

View reference