curl --location --request PATCH 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../draft' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
"expectedVersion": 1,
"sourceLanguage": "en",
"targetLanguages": ["es", "fr"],
"keyterms": ["MyVocal"],
"cloningStrength": 7
}'
{
"code": 1,
"message": "success",
"data": {
"projectId": "ip_...",
"settingsVersion": 2,
"state": "DRAFT",
"sourceLanguage": "en",
"keyterms": ["MyVocal"],
"cloningStrength": 7,
"targetLanguages": ["es", "fr"],
"sourceDurationMs": "0",
"sourceState": "DRAFT",
"requestId": "..."
}
}
Quote and generate
Patch the interpretation draft
Update the source language, keyterms, cloning strength and target languages of a draft.
PATCH
/
sound_clone
/
api
/
v1
/
interpretation
/
projects
/
{projectId}
/
draft
curl --location --request PATCH 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../draft' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
"expectedVersion": 1,
"sourceLanguage": "en",
"targetLanguages": ["es", "fr"],
"keyterms": ["MyVocal"],
"cloningStrength": 7
}'
{
"code": 1,
"message": "success",
"data": {
"projectId": "ip_...",
"settingsVersion": 2,
"state": "DRAFT",
"sourceLanguage": "en",
"keyterms": ["MyVocal"],
"cloningStrength": 7,
"targetLanguages": ["es", "fr"],
"sourceDurationMs": "0",
"sourceState": "DRAFT",
"requestId": "..."
}
}
Interpretation · Translate and dub uploaded audio/video · Workflow: Interpretation quickstart · Polling: Async jobs and retries
Updates only the fields you provide. This is a patch, not a replace.
Header
Your API key. See Authentication.
Path
Body
Optional concurrency guard. If present and different from the current version, the request is rejected with
47116.null, an empty string or AUTO normalizes to automatic detection. Omitting the field keeps the stored value — it does not clear it.Replaces the whole list when provided. Up to 1000 entries; each up to 50 code points, up to 5 words, and without
< > { } [ ] \. An empty array clears the list.0–10. When omitted or null, the stored value is kept; 7 is only used as a fallback when the draft has no value at all.Response
curl --location --request PATCH 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../draft' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
"expectedVersion": 1,
"sourceLanguage": "en",
"targetLanguages": ["es", "fr"],
"keyterms": ["MyVocal"],
"cloningStrength": 7
}'
{
"code": 1,
"message": "success",
"data": {
"projectId": "ip_...",
"settingsVersion": 2,
"state": "DRAFT",
"sourceLanguage": "en",
"keyterms": ["MyVocal"],
"cloningStrength": 7,
"targetLanguages": ["es", "fr"],
"sourceDurationMs": "0",
"sourceState": "DRAFT",
"requestId": "..."
}
}
“Field omitted or
null” keeps the current value for sourceLanguage, keyterms, cloningStrength and targetLanguages; a provided array — including an empty one — replaces the whole list. Do not use null to clear a field.Common errors
code = 47116:expectedVersiondoes not match the current version.code = 47123: the draft is frozen because a source version was already committed; remove the source first.code = 47101: an invalid value, for example a keyterm that is too long or contains a forbidden character.code = 47102: the project does not exist or is not owned by your account.