> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Een vertaald video- of audioproject maken
> Maak een project van je geüploade fileKey, transcribeer en vertaal het en genereer vervolgens de spraak. Ondersteunt eigen SRT, stemmen, ondertitels en optionele lipsynchronisatie. Gebruikt de gebruikelijke mediacredits. Een optionele webhookUrl ontvangt verwerkingsgebeurtenissen. Controleer projects_status.
Maak een project van je geüploade fileKey, transcribeer en vertaal het en genereer vervolgens de spraak. Ondersteunt eigen SRT, stemmen, ondertitels en optionele lipsynchronisatie. Gebruikt de gebruikelijke mediacredits. Een optionele webhookUrl ontvangt verwerkingsgebeurtenissen. Controleer projects\_status.
```http theme={null}
POST https://api.voicecheap.ai/v1/actions/translations_create
```
## Authenticatie en machtigingen
Stuur een VoiceCheap API-sleutel mee in deze header. Authorization: Bearer met dezelfde API-sleutel wordt ook ondersteund. OAuth-toegangstokens
worden alleen door MCP geaccepteerd, niet door dit REST-endpoint.
Vereiste machtigingen: `projects:write`, `translations:write`, `transcription:write`.
Een actief betaald abonnement is vereist. Machtigingen wijzigen geen teamrollen, eigendom van resources, mediategoed of abonnementslimieten.
## Parameters
Tekstwaarde.
Minimale lengte: 1. Maximale lengte: 1024.
Tekstwaarde.
Toegestane waarden: "afrikaans", "albanian", "amharic", "arabic", "armenian", "assamese", "azerbaijani", "basque", "belarusian", "bengali", "bosnian", "bulgarian", "catalan", "croatian", "czech", "danish", "dutch", "english", "british english", "estonian", "finnish", "french", "french canadian", "galician", "german", "greek", "gujarati", "hebrew", "hindi", "hungarian", "icelandic", "indonesian", "irish", "italian", "japanese", "kannada", "kazakh", "khmer", "korean", "lao", "latvian", "lithuanian", "macedonian", "malay", "malayalam", "mandarin", "marathi", "mongolian", "nepali", "norwegian", "persian", "polish", "portuguese", "brazilian portuguese", "pt\_brazil", "punjabi", "romanian", "russian", "serbian", "slovak", "slovenian", "spanish", "swahili", "swedish", "tagalog", "tamil", "telugu", "thai", "turkish", "ukrainian", "urdu", "vietnamese", "welsh", "yoruba", "zulu".
Tekstwaarde.
Toegestane waarden: "af", "sq", "am", "ar", "hy", "as", "ast", "az", "ba", "eu", "be", "bn", "bs", "br", "bg", "my", "ca", "ceb", "zh", "hr", "cs", "da", "nl", "en", "eo", "at", "et", "fil", "fo", "fi", "fr", "fr-CA", "fy", "ff", "gd", "gl", "lg", "ka", "de", "el", "gu", "ht", "ha", "haw", "he", "hi", "hu", "is", "ig", "ilo", "id", "ia", "ga", "it", "ja", "jv", "kea", "kn", "kk", "km", "kur", "kir", "ko", "lo", "la", "luo", "lv", "lb", "ln", "lt", "mk", "mg", "ms", "ml", "mt", "mi", "mr", "mo", "mn", "ne", "no", "nn", "nso", "nya", "oc", "or", "pa", "ps", "fa", "pl", "pt", "ro", "ru", "sa", "sr", "sn", "sd", "si", "sk", "sl", "so", "es", "su", "sw", "ss", "sv", "tl", "tg", "ta", "tt", "te", "th", "bo", "tn", "tr", "tk", "ug", "uk", "umb", "ur", "uz", "vi", "cy", "wo", "xh", "yi", "yo", "zu", "cmn", "yue", "en-GB", "en-US", "en-AU", "auto-detect".
Tekstwaarde.
Minimale lengte: 1. Maximale lengte: 200.
Tekstwaarde.
Toegestane waarden: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "auto-detect".
Lijst met waarden. Zie het volledige invoerschema voor de structuur van de items.
Maximaal aantal items: 1000.
Booleaanse waarde.
Tekstwaarde.
Maximale lengte: 1000000.
Tekstwaarde.
Maximale lengte: 2048. Formaat: "uri".
Optioneel op transportniveau: als de identificatie ontbreekt, voegt de server deze vóór de validatie toe. Geef zelf een stabiele UUID v4 op om veilig te kunnen herstellen als een antwoord verloren gaat.
Formaat: "uuid". Patroon: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$`.
Booleaanse waarde.
Booleaanse waarde.
Numerieke waarde.
Minimum: 1. Maximum: 70.
Tekstwaarde.
Toegestane waarden: "cloning", "custom".
Tekstwaarde.
Minimale lengte: 1. Maximale lengte: 128.
Booleaanse waarde.
Tekstwaarde.
Toegestane waarden: "translated", "original".
Tekstwaarde.
Toegestane waarden: "studio", "realistic".
Tekstwaarde.
Toegestane waarden: "standard", "pro", "studio".
Booleaanse waarde.
JSON-object. Zie het volledige invoerschema voor de geneste velden.
Lijst met waarden. Zie het volledige invoerschema voor de structuur van de items.
Maximaal aantal items: 100.
Tekstwaarde.
Maximale lengte: 1000000.
Het onderstaande JSON Schema behoudt de exacte veldnamen, geneste typen, standaardwaarden, grenzen en toegestane waarden die discovery beschikbaar stelt. Aanvullende regels tussen velden staan in de opmerkingen bij de bewerking.
```json theme={null}
{
"type": "object",
"properties": {
"fileKey": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"targetLanguage": {
"type": "string",
"enum": [
"afrikaans",
"albanian",
"amharic",
"arabic",
"armenian",
"assamese",
"azerbaijani",
"basque",
"belarusian",
"bengali",
"bosnian",
"bulgarian",
"catalan",
"croatian",
"czech",
"danish",
"dutch",
"english",
"british english",
"estonian",
"finnish",
"french",
"french canadian",
"galician",
"german",
"greek",
"gujarati",
"hebrew",
"hindi",
"hungarian",
"icelandic",
"indonesian",
"irish",
"italian",
"japanese",
"kannada",
"kazakh",
"khmer",
"korean",
"lao",
"latvian",
"lithuanian",
"macedonian",
"malay",
"malayalam",
"mandarin",
"marathi",
"mongolian",
"nepali",
"norwegian",
"persian",
"polish",
"portuguese",
"brazilian portuguese",
"pt_brazil",
"punjabi",
"romanian",
"russian",
"serbian",
"slovak",
"slovenian",
"spanish",
"swahili",
"swedish",
"tagalog",
"tamil",
"telugu",
"thai",
"turkish",
"ukrainian",
"urdu",
"vietnamese",
"welsh",
"yoruba",
"zulu"
]
},
"originalLanguage": {
"type": "string",
"enum": [
"af",
"sq",
"am",
"ar",
"hy",
"as",
"ast",
"az",
"ba",
"eu",
"be",
"bn",
"bs",
"br",
"bg",
"my",
"ca",
"ceb",
"zh",
"hr",
"cs",
"da",
"nl",
"en",
"eo",
"at",
"et",
"fil",
"fo",
"fi",
"fr",
"fr-CA",
"fy",
"ff",
"gd",
"gl",
"lg",
"ka",
"de",
"el",
"gu",
"ht",
"ha",
"haw",
"he",
"hi",
"hu",
"is",
"ig",
"ilo",
"id",
"ia",
"ga",
"it",
"ja",
"jv",
"kea",
"kn",
"kk",
"km",
"kur",
"kir",
"ko",
"lo",
"la",
"luo",
"lv",
"lb",
"ln",
"lt",
"mk",
"mg",
"ms",
"ml",
"mt",
"mi",
"mr",
"mo",
"mn",
"ne",
"no",
"nn",
"nso",
"nya",
"oc",
"or",
"pa",
"ps",
"fa",
"pl",
"pt",
"ro",
"ru",
"sa",
"sr",
"sn",
"sd",
"si",
"sk",
"sl",
"so",
"es",
"su",
"sw",
"ss",
"sv",
"tl",
"tg",
"ta",
"tt",
"te",
"th",
"bo",
"tn",
"tr",
"tk",
"ug",
"uk",
"umb",
"ur",
"uz",
"vi",
"cy",
"wo",
"xh",
"yi",
"yo",
"zu",
"cmn",
"yue",
"en-GB",
"en-US",
"en-AU",
"auto-detect"
]
},
"projectName": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"numberOfSpeakers": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32",
"auto-detect"
]
},
"brandVocabulary": {
"maxItems": 1000,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"removeFillerWords": {
"type": "boolean"
},
"sourceSrt": {
"type": "string",
"maxLength": 1000000
},
"webhookUrl": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
"description": "UUID v4 for this action. Reuse the same ID with identical arguments on retries."
},
"keepBackgroundMusic": {
"type": "boolean"
},
"keepOriginalVoice": {
"type": "boolean"
},
"originalVoiceVolume": {
"type": "number",
"minimum": 1,
"maximum": 70
},
"voiceMode": {
"type": "string",
"enum": ["cloning", "custom"]
},
"voiceId": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"subtitles": {
"type": "boolean"
},
"subtitlesSource": {
"type": "string",
"enum": ["translated", "original"]
},
"voiceIsolatorOption": {
"type": "string",
"enum": ["studio", "realistic"]
},
"lipSyncMode": {
"type": "string",
"enum": ["standard", "pro", "studio"]
},
"activeSpeakerDetectionEnabled": {
"type": "boolean"
},
"voiceCloningSettings": {
"type": "object",
"properties": {
"stability": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"similarity": {
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": ["stability", "similarity"],
"additionalProperties": false
},
"translationTimeSkips": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"startTime": {
"type": "number",
"minimum": 0
},
"endTime": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": ["startTime", "endTime"],
"additionalProperties": false
}
},
"translatedSrt": {
"type": "string",
"maxLength": 1000000
}
},
"required": ["fileKey", "targetLanguage"],
"additionalProperties": false
}
```
## Idempotentie
Gebruik voor elke wijziging een UUID v4 in requestId of de HTTP-header Idempotency-Key. Gebruik na een netwerkfout dezelfde identificatie en identieke argumenten opnieuw. Als je beide opgeeft, moeten ze overeenkomen. Het opnieuw versturen van een opgeslagen aanvraag herhaalt de bewerking niet en verbruikt geen extra maandelijkse aanroep. Mislukte of onderbroken aanvragen worden niet automatisch opnieuw gestart.
Elke wijziging kan HTTP 202 retourneren wanneer een nieuwe poging vaststelt dat dezelfde aanvraag nog loopt, ook wanneer de eerste uitvoering normaal synchroon is. Als de uitvoering is voltooid maar resultStored false is, retourneert een nieuwe poging HTTP 200 met de opgeslagen aanvraagstatus in plaats van het oorspronkelijke resultaat. Haal de uitvoer op via de geschiedenis-, resultaat- of downloadactie van het betreffende domein.
## Voorbeeldaanvragen
Vervang de voorbeeldidentificaties van resources en mediasleutels door waarden die voor je account zijn geretourneerd. Behoud dezelfde aanvraagidentificatie wanneer je dezelfde wijziging opnieuw probeert.
```bash cURL theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/translations_create' \
--header "x-api-key: $VOICECHEAP_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"fileKey":"uploads/your-user-id/6bee76be-109f-423a-88fb-f41e2aa1f03b-launch.mp4","targetLanguage":"english","originalLanguage":"fr","projectName":"Product launch","numberOfSpeakers":"auto-detect","brandVocabulary":["VoiceCheap"],"removeFillerWords":true,"requestId":"41321bda-e243-4b6f-96a4-622cd047c991","keepBackgroundMusic":true,"keepOriginalVoice":false,"voiceMode":"cloning","subtitles":true,"subtitlesSource":"translated","voiceIsolatorOption":"studio"}'
```
```javascript JavaScript theme={null}
const input = {
fileKey: 'uploads/your-user-id/6bee76be-109f-423a-88fb-f41e2aa1f03b-launch.mp4',
targetLanguage: 'english',
originalLanguage: 'fr',
projectName: 'Product launch',
numberOfSpeakers: 'auto-detect',
brandVocabulary: ['VoiceCheap'],
removeFillerWords: true,
requestId: '41321bda-e243-4b6f-96a4-622cd047c991',
keepBackgroundMusic: true,
keepOriginalVoice: false,
voiceMode: 'cloning',
subtitles: true,
subtitlesSource: 'translated',
voiceIsolatorOption: 'studio',
};
const response = await fetch('https://api.voicecheap.ai/v1/actions/translations_create', {
method: 'POST',
headers: {
'x-api-key': process.env.VOICECHEAP_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);
```
```python Python theme={null}
import os
import requests
response = requests.post(
"https://api.voicecheap.ai/v1/actions/translations_create",
headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
json={"fileKey": "uploads/your-user-id/6bee76be-109f-423a-88fb-f41e2aa1f03b-launch.mp4", "targetLanguage": "english", "originalLanguage": "fr", "projectName": "Product launch", "numberOfSpeakers": "auto-detect", "brandVocabulary": ["VoiceCheap"], "removeFillerWords": True, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991", "keepBackgroundMusic": True, "keepOriginalVoice": False, "voiceMode": "cloning", "subtitles": True, "subtitlesSource": "translated", "voiceIsolatorOption": "studio"},
timeout=120,
)
body = response.json()
if not response.ok:
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)
```
## Antwoord
Een geslaagde eerste uitvoering retourneert HTTP 200 met het resultaat van de bewerking onder data. Een herhaalde aanvraag kan in plaats daarvan de opgeslagen aanvraagstatus retourneren. Het voorbeeld toont één ondersteund antwoord, niet alle optionele velden.
Retourneert een nieuwe project-ID na het starten van transcriptie gevolgd door vertaling en spraakgeneratie, of nasynchronisatie met een aangeleverde vertaling.
```json HTTP 200 theme={null}
{
"data": {
"success": true,
"message": "Translation started successfully. Use the status endpoint to track progress.",
"projectId": "project_launch_2026",
"estimatedDuration": 10
},
"requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}
```
```json HTTP 202 replay_running theme={null}
{
"data": {
"requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
"operation": "translations_create",
"createdAt": 1792144800000,
"updatedAt": 1792144820000,
"status": "running",
"pollAfterSeconds": 5
},
"requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}
```
```json HTTP 200 replay_completed_without_result theme={null}
{
"data": {
"requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
"operation": "translations_create",
"createdAt": 1792144800000,
"updatedAt": 1792144820000,
"status": "completed",
"resultStored": false,
"message": "The action completed. Retrieve its output from the corresponding history or resource action."
},
"requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
}
```
## Resultaatvelden
| Veld | Beschrijving |
| - | - |
| `data.success` | True wanneer de achtergrondworkflow is toegelaten; dit geeft niet aan dat de media zijn voltooid. |
| `data.message` | Bevestiging van vertaling of nasynchronisatie met een aangeleverde vertaling. |
| `data.projectId` | ID van het bovenliggende project. |
| `data.estimatedDuration` | Ruwe schatting van de verwerkingstijd in minuten: ceil(source duration in seconds / 60) \* 5. |
## translatedSrt is opgegeven en geaccepteerd.
Dezelfde resultaatvelden bevestigen de nasynchronisatie van de opgegeven doeltekst.
```json HTTP 200 theme={null}
{
"data": {
"success": true,
"message": "Dubbing started successfully from the provided translation. Use the status endpoint to track progress.",
"projectId": "project_launch_2026",
"estimatedDuration": 10
}
}
```
## Deze aanvraag herstellen en controleren
Gebruik dezelfde identificatie, ook nadat de verbinding is verbroken. Als resultStored false is, haal je de uitvoer op via de bijbehorende geschiedenis-, resultaat- of downloadactie. Start nooit een tweede generatie alleen om de voortgang te controleren.
```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/action_request_get' \
--header "x-api-key: $VOICECHEAP_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"requestId":"41321bda-e243-4b6f-96a4-622cd047c991","operation":"translations_create"}'
```
```json HTTP 200 theme={null}
{
"data": {
"requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
"operation": "translations_create",
"status": "completed",
"createdAt": 1792144800000,
"updatedAt": 1792144820000,
"resultStored": true,
"result": {
"success": true,
"message": "Translation started successfully. Use the status endpoint to track progress.",
"projectId": "project_launch_2026",
"estimatedDuration": 10
}
}
}
```
## Opmerkingen bij de bewerking
* De voltooide fileKey moet van de geauthenticeerde uitvoerende gebruiker zijn. De server meet de duur en grootte van de opgeslagen media.
* Een optionele sourceSrt vereist een expliciete originalLanguage. Wanneer ook translatedSrt wordt opgegeven, moeten beide SRT's hetzelfde aantal ondertitelblokken hebben; de aangeleverde vertaling wordt gekoppeld op basis van de ondertitelblokindex.
* Wanneer translatedSrt is opgegeven, voert de workflow nasynchronisatie van die tekst uit en retourneert deze de bevestiging voor de opgegeven vertaling. Met sourceSrt gebeurt de uitlijning van ondertitelblokken op index; zonder sourceSrt wordt de tijdlijn van de automatische transcriptie gebruikt.
* Het aanmaakresultaat bevat geen workId of translatedVersionId. Haal deze op via projects\_status of projects\_get zodra ze bestaan.
* voiceMode gebruikt standaard cloning. Gebruik bij voiceMode custom een catalogusstem of een aangepaste stem die door het geauthenticeerde account is opgeslagen; geef geen voiceCloningSettings mee. Teamfacturering geeft geen toegang tot de opgeslagen stemmen van andere leden.
* De optionele subtitles, lipSyncMode en translationTimeSkips vereisen video-invoer. Overgeslagen bereiken moeten binnen de mediaduur blijven, keepBackgroundMusic moet true zijn en keepOriginalVoice moet false zijn.
* lipSyncMode accepteert standard, pro of studio, afhankelijk van het abonnement en de normale controles op mediategoed. Spraak en lipsynchronisatie worden niet gratis doordat het aantal maandelijkse API-aanroepen onbeperkt is.
* Peil projects\_status voor de mediaworkflow; haal alle taalversies op met projects\_get.
* originalLanguage gebruikt brontaalcodes zoals fr of en (of auto-detect waar dit wordt geaccepteerd); targetLanguage gebruikt ondersteunde doeltaalnamen zoals english.
## Verbruik
Elke geslaagde aanroep verbruikt één maandelijkse API/MCP-aanroep. Ook het mediategoed en de eigen generatielimieten van de bewerking zijn van toepassing.
## Fouten
| HTTP-status | Code | Betekenis of herstel |
| - | - | - |
| 400 | `CREDENTIAL_IN_QUERY` | Inloggegevens zijn opgegeven in een queryparameter access\_token of api\_key. Stuur inloggegevens in headers. |
| 400 | `FILE_TOO_LARGE` | De opgeslagen upload overschrijdt de uploadgroottelimiet van het account. |
| 400 | `IDEMPOTENCY_CONFLICT` | De header Idempotency-Key en het bodyveld requestId moeten overeenkomen. |
| 400 | `INVALID_FILE_TYPE` | De geüploade bestandsnaam heeft geen ondersteunde audio- of video-extensie. |
| 400 | `INVALID_MEDIA_DURATION` | De gemeten duur is ongeldig of overschrijdt de abonnementsgrens. |
| 400 | `INVALID_REQUEST_ID` | Geef een UUID v4 op als requestId of Idempotency-Key. |
| 400 | `INVALID_SOURCE_SRT` | sourceSrt moet geldige SRT-ondertitelblokken bevatten. |
| 400 | `INVALID_TRANSLATED_SRT` | De aangeleverde SRT in de doeltaal heeft een ongeldige indeling. |
| 400 | `LIPSYNC_NOT_AVAILABLE_FOR_AUDIO` | Lipsynchronisatie vereist video-invoer. |
| 400 | `LIPSYNC_VIDEO_TOO_LONG` | De video overschrijdt de maximale duur voor de geselecteerde lipsynchronisatiemodus. |
| 400 | `SOURCE_LANGUAGE_REQUIRED_FOR_SRT` | Stel originalLanguage expliciet in wanneer je sourceSrt opgeeft. |
| 400 | `SUBTITLES_NOT_AVAILABLE_FOR_AUDIO` | Ingebrande ondertitels vereisen video-invoer. |
| 400 | `TRANSLATED_SRT_CUE_COUNT_MISMATCH` | Wanneer sourceSrt en translatedSrt samen worden opgegeven, moeten beide hetzelfde aantal ondertitelblokken bevatten. |
| 400 | `TRANSLATION_TIME_SKIP_CONFLICT` | Tijdsintervallen overslaan bij vertaling kan niet worden gecombineerd met keepOriginalVoice true. |
| 400 | `TRANSLATION_TIME_SKIP_NOT_AVAILABLE_FOR_AUDIO` | Voor het overslaan van tijdsintervallen in een vertaling is video-invoer vereist. |
| 400 | `TRANSLATION_TIME_SKIP_OUT_OF_RANGE` | Een overgeslagen bereik reikt voorbij de mediaduur. |
| 400 | `TRANSLATION_TIME_SKIP_REQUIRES_BACKGROUND` | Voor het overslaan van tijdsintervallen in een vertaling moet keepBackgroundMusic true zijn. |
| 400 | `VALIDATION_ERROR` | Corrigeer de invoer aan de hand van het schema. Ongeldige of tegenstrijdige waarden worden vóór de uitvoering geweigerd. |
| 400 | `VOICE_CLONING_SETTINGS_NOT_ALLOWED` | voiceCloningSettings zijn alleen van toepassing op voiceMode cloning. |
| 400 | `VOICE_ID_NOT_ALLOWED_WITH_CLONING` | voiceId kan niet worden gecombineerd met voiceMode cloning. |
| 400 | `VOICE_ID_REQUIRED` | voiceMode custom vereist voiceId. |
| 401 | `API_KEY_EXPIRED` | De API-sleutel is verlopen. |
| 401 | `INVALID_API_KEY` | Geef een geldige, niet-verlopen API-sleutel op. |
| 401 | `INVALID_CREDENTIAL` | De Authorization-header heeft een ongeldige indeling of is in strijd met x-api-key. |
| 401 | `MISSING_CREDENTIAL` | Er is geen bruikbaar authenticatiemiddel in de header opgegeven, of het overschreed 4096 tekens. |
| 401 | `USER_NOT_FOUND` | Het account dat bij de toegangsgegevens hoort, bestaat niet meer. |
| 403 | `ACCOUNT_UNAVAILABLE` | Het uitvoerende of factureringsaccount is niet beschikbaar of wordt verwijderd. |
| 403 | `AMBIGUOUS_TEAM_API_KEY` | De gebruiker van het authenticatiemiddel behoort tot meer dan één team, waardoor de factureringscontext onduidelijk is. |
| 403 | `CUSTOM_VOICE_ACCESS_DENIED` | De geselecteerde stem is geen catalogusstem of aangepaste stem die door het geauthenticeerde account is opgeslagen. |
| 403 | `INSUFFICIENT_CREDITS` | Het account heeft onvoldoende mediategoed voor de geselecteerde spraakinstellingen en optionele instellingen voor lipsynchronisatie. |
| 403 | `INSUFFICIENT_SCOPE` | Verleen alle vereiste machtigingen of kies andere toegangsgegevens. |
| 403 | `INTEGRATION_PLAN_UNSUPPORTED` | De integratielimieten van het account konden niet worden geverifieerd. |
| 403 | `INVALID_FILE_REFERENCE` | fileKey moet een voltooide upload aanduiden die van de geauthenticeerde uitvoerende gebruiker is. |
| 403 | `LIPSYNC_MODE_ACCESS_DENIED` | De geselecteerde optionele lipsynchronisatiemodus is niet beschikbaar met het huidige abonnement. |
| 403 | `SUBSCRIPTION_REQUIRED` | Gebruik een actief betaald abonnement. |
| 403 | `TEAM_OWNER_NOT_FOUND` | Het effectieve account van de teameigenaar kon niet worden gevonden. |
| 404 | `MEDIA_NOT_FOUND` | Het geüploade object ontbreekt of is leeg. |
| 409 | `CONCURRENT_ACTION_LIMIT_REACHED` | Voor dit account worden al 10 integratieacties uitgevoerd. Controleer een bestaande aanvraag voordat je een nieuwe start. |
| 409 | `IDEMPOTENCY_CONFLICT` | Gebruik een identificatie alleen opnieuw met dezelfde bewerking en argumenten. |
| 429 | `CONCURRENT_TRANSLATION_LIMIT_REACHED` | Het account heeft al het maximale aantal gelijktijdige API-vertalingen. |
| 429 | `INTEGRATION_MONTHLY_LIMIT_REACHED` | Wacht tot de maandelijkse reset of wijzig je abonnement. |
| 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Wacht de tijd uit Retry-After af wanneer deze aanwezig is en vergroot de wachttijd tussen nieuwe pogingen. |
| 500 | `INTERNAL_ERROR` | Controleer de opgeslagen aanvraagstatus en de resourcegeschiedenis voordat je besluit een wijziging opnieuw te proberen. |
| 503 | `ACTION_RESULT_UNAVAILABLE` | De actie is uitgevoerd, maar het resultaat kon niet worden opgeslagen. Controleer de opgeslagen aanvraagstatus en resourcegeschiedenis voordat je een nieuwe generatie start. |
| 503 | `SERVER_RESTARTING` | De server wordt opnieuw gestart. Probeer het zo opnieuw en behoud bij een wijziging dezelfde aanvraagidentificatie. |
```json theme={null}
{
"code": "INSUFFICIENT_SCOPE",
"message": "This credential does not permit the requested action.",
"status": 403,
"details": {
"requiredScopes": ["projects:write", "translations:write", "transcription:write"]
}
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.