Skip to main content

​
API-referentie

De VoiceCheap API gebruikt standaard HTTP-methoden en statuscodes. De meeste endpoints retourneren JSON; transcript-exports kunnen ook SRT of VTT retourneren. Gebruik de actiecatalogus voor accountinstellingen, teambeheer, mediatools en andere workflows. Deze workflows zijn ook beschikbaar via de MCP-server voor je account, behalve het aanmaken en roteren van webhook-ondertekeningsgeheimen; daarvoor is REST vereist. Beheer inloggegevens bij Integraties en bekijk de gebruikslimieten.

​
Basis-URL

Alle API-verzoeken moeten worden gedaan aan:

​
Authenticatie

Authenticeer privé-REST-aanroepen met een API-sleutel in x-api-key of Authorization: Bearer. Het OpenAPI-document is openbaar. Zie Authenticatie voor inloggegevens met beperkte machtigingen en OAuth voor MCP.

​
JSON-actie-API

De onderdelen voor account, team, projecten, stemmen en mediatools beschrijven elke JSON-actie apart. Deze routes gebruiken allemaal POST, ook voor lezen en verwijderen; stuur de argumenten in de JSON-body. De onderstaande routes voor bestandsuploads en bestaande projecten behouden hun eigen HTTP-methoden. Maak een API-sleutel met account:read, stel de omgevingsvariabele VOICECHEAP_API_KEY in en probeer deze alleen-lezenaanvraag:
Een voltooide actie retourneert HTTP 200 met het resultaat in data. Een langdurige actie retourneert HTTP 202 en een requestId; lees de aanvraagstatus om het resultaat op te halen. Een mediataak kan doorgaan nadat de actieaanvraag is voltooid. Bekijk alle acties per onderdeel of ontdek welke acties en schema’s voor je sleutel zijn toegestaan. Elke pagina vermeldt de rechten, parameters, voorbeelden en fouten.

​
Inhoudstypen

  • Verzoek: Gebruik multipart/form-data voor bestandsuploads, application/json voor andere verzoeken
  • Antwoord: JSON-eindpunten retourneren application/json. Transcript-exports kunnen ook SRT- of VTT-tekst retourneren.

​
Bestandsuploads en bestaande projectroutes

Media transcriberen

POST /v1/transcribeTranscribeer een geüpload bestand als JSON, SRT of VTT.

Projecttranscript exporteren

POST /v1/projects/{projectId}/transcriptHaal originele of vertaalde projecttranscripts op.

Project aanmaken

POST /v1/projectsUpload een video- of audiobestand en start alleen de transcriptie.

Vertaling starten

POST /v1/translateUpload een video- of audiobestand en start een vertaalproject.

Project nasynchroniseren

POST /v1/projects/{projectId}/dubSynchroniseer een getranscribeerd project met uw eigen vertaalde SRT-bestand.

Vertaalstatus ophalen

GET /v1/translate/{projectId}/statusControleer de status van een vertaalproject en haal resultaten op.

Projectdetails ophalen

GET /v1/projects/{projectId}Haal de vertaalde versiegeschiedenis, lipsynchronisatie-geschiedenis en projectstatus op.

Project verwijderen

DELETE /v1/translate/{projectId}Verwijder een vertaalproject en de bijbehorende assets permanent.

​
Vertaalworkflow

De typische workflow voor het vertalen van een video is:

​
Antwoordformaat

De onderstaande bestaande bestandsupload- en projectroutes behouden hun eigen antwoordformaten. De velden in een geslaagd antwoord verschillen per endpoint. Verzoeken om een project aan te maken of nasynchronisatie te starten retourneren success, message en projectId. Status- en projectdetailverzoeken geven de projectstatus terug; transcriptverzoeken retourneren JSON, SRT of VTT. Raadpleeg de endpointpagina voor de exacte velden. Fouten geven een JSON-object met code en message terug, soms ook met details. Zie Foutcodes.

​
HTTP-statuscodes