Skip to main content

API-referentie

De VoiceCheap API is georganiseerd rond REST-principes. Het gebruikt standaard HTTP-methoden, retourneert JSON-gecodeerde antwoorden en gebruikt standaard HTTP-antwoordcodes.

Basis-URL

Alle API-verzoeken moeten worden gedaan aan:

Authenticatie

Alle verzoeken vereisen een API-sleutel die wordt doorgegeven in de x-api-key-header. Zie de Authenticatie-pagina voor details.

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.

Beschikbare eindpunten

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.

Vertaling starten

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

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

Alle succesvolle antwoorden volgen deze algemene structuur:
Foutmeldingen volgen deze structuur:

HTTP-statuscodes