Quote interpretation targets

Price the translation and dubbing of the requested target languages.

POST /sound_clone/api/v1/interpretation/projects/{projectId}/quotes

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../quotes' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{ "settingsVersion": 1, "targetLanguages": ["es", "fr"] }'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "quoteId": "iq_...",
    "projectId": "ip_...",
    "settingsVersion": 1,
    "sourceDurationMs": "90000",
    "planKey": "PRO",
    "rateVersion": "interp-2026-09-27-v1",
    "charactersPerMinutePerLanguage": 4000,
    "perTargetCharacters": "6000",
    "requestedLanguages": ["es", "fr"],
    "existingTargets": [],
    "newTargets": [ { "language": "es", "characters": "6000" }, { "language": "fr", "characters": "6000" } ],
    "targets": [ { "language": "es", "characters": "6000" }, { "language": "fr", "characters": "6000" } ],    "totalCharacters": "12000",
    "availableCharacters": "20000",
    "estimatedRemainingCharacters": "8000",
    "balanceState": "AVAILABLE",
    "state": "ACTIVE",
    "expiresAt": "2027-01-15T16:05:00",
    "requestId": "..."
  }
}

Quoting is free. The price is per new target language: adding a language to an existing project charges only for the language being added.

Header

accessKey · string · required

API key for authentication.

Path

projectId · string · required

The project identifier. The source must already be ready.

Body

settingsVersion · number

Optional. If present and different from the current version, the request is rejected with 47109.

targetLanguages · array · required

The languages to price. Must not be empty.

Response

quoteId · string | null

Pass this to the generation endpoint. null when state is ALL_TARGETS_EXIST.

projectId · string

Project identifier.

settingsVersion · number

Draft version the quote was based on.

sourceDurationMs · string

Source duration, as a string.

planKey · string

The plan the rate came from.

rateVersion · string

Rate version label.

charactersPerMinutePerLanguage · number

The rate applied, per language.

perTargetCharacters · string | null

Characters per new language, as a string.

requestedLanguages · array

The languages you asked for.

existingTargets · array

Languages that already exist for this source: { language, characters, targetId, state, action }.

newTargets · array

Languages that will be created and charged.

targets · array

The languages a submission would create and reserve now. This field is the same content as newTargets, kept under its pre-decision name — it is not a union of existingTargets and newTargets, and it excludes languages the project already carries.

totalCharacters · string

Total charge, as a string. "0" for ALL_TARGETS_EXIST.

availableCharacters · string | null

Available balance, as a string.

estimatedRemainingCharacters · string | null

Projected balance, as a string.

balanceState · string | null

AVAILABLE or LEDGER_UNAVAILABLE for this response, or null. It describes the balance fields of this response only; a LEDGER_UNAVAILABLE value means availableCharacters and estimatedRemainingCharacters are null rather than guessed.

state · string

ACTIVE, ALL_TARGETS_EXIST or CHANGED.

expiresAt · string | null

When the quote expires (time to live quoteTtlSeconds, normally 600 seconds).

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/interpretation/projects/ip_.../quotes' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{ "settingsVersion": 1, "targetLanguages": ["es", "fr"] }'

200 Success

{
  "code": 1,
  "message": "success",
  "data": {
    "quoteId": "iq_...",
    "projectId": "ip_...",
    "settingsVersion": 1,
    "sourceDurationMs": "90000",
    "planKey": "PRO",
    "rateVersion": "interp-2026-09-27-v1",
    "charactersPerMinutePerLanguage": 4000,
    "perTargetCharacters": "6000",
    "requestedLanguages": ["es", "fr"],
    "existingTargets": [],
    "newTargets": [ { "language": "es", "characters": "6000" }, { "language": "fr", "characters": "6000" } ],
    "targets": [ { "language": "es", "characters": "6000" }, { "language": "fr", "characters": "6000" } ],    "totalCharacters": "12000",
    "availableCharacters": "20000",
    "estimatedRemainingCharacters": "8000",
    "balanceState": "AVAILABLE",
    "state": "ACTIVE",
    "expiresAt": "2027-01-15T16:05:00",
    "requestId": "..."
  }
}

ALL_TARGETS_EXIST is a successful quote, not an error. quoteId is null and totalCharacters is "0" — read existingTargets and never call the generation endpoint with a null quoteId. All Characters values are JSON strings; convert them before comparing.

Common errors

• code = 47101: targetLanguages is missing or empty.
• code = 47109: the quote is no longer valid for this settings version, or the version changed.
• code = 47108: the quote has expired.
• code = 47103: the source is not ready yet.
• code = 47119: an ENTERPRISE account has no configured contract rate.
• code = 47128: the plan is not entitled to generate.
• code = 47102: the project does not exist or is not owned by your account.