> ## 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.

# API-referentie

> Volledige referentie voor de VoiceCheap REST API

# 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](https://api-docs.voicecheap.ai/docs/nl/api-reference/actions.md) voor accountinstellingen, teambeheer, mediatools en andere workflows. Deze workflows zijn ook beschikbaar via de [MCP-server voor je account](https://api-docs.voicecheap.ai/docs/nl/ai/model-context-protocol.md), behalve het aanmaken en roteren van webhook-ondertekeningsgeheimen; daarvoor is REST vereist. Beheer inloggegevens bij [Integraties](https://api-docs.voicecheap.ai/docs/nl/ai/integrations.md) en bekijk de [gebruikslimieten](https://api-docs.voicecheap.ai/docs/nl/api-reference/limits.md).

## Basis-URL

Alle API-verzoeken moeten worden gedaan aan:

```text theme={null}
https://api.voicecheap.ai
```

## Authenticatie

Authenticeer privé-REST-aanroepen met een API-sleutel in `x-api-key` of `Authorization: Bearer`. Het OpenAPI-document is openbaar. Zie [Authenticatie](https://api-docs.voicecheap.ai/docs/nl/authentication.md) 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:

```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/account_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'
```

Een voltooide actie retourneert HTTP 200 met het resultaat in `data`. Een langdurige actie retourneert HTTP 202 en een `requestId`; lees de [aanvraagstatus](https://api-docs.voicecheap.ai/docs/nl/api-reference/actions/requests/action-request-get.md) om het resultaat op te halen. Een mediataak kan doorgaan nadat de actieaanvraag is voltooid.

Bekijk [alle acties per onderdeel](https://api-docs.voicecheap.ai/docs/nl/api-reference/actions.md) of [ontdek welke acties en schema’s voor je sleutel zijn toegestaan](https://api-docs.voicecheap.ai/docs/nl/api-reference/discovery/actions-list.md). 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

> [card] [Media transcriberen](https://api-docs.voicecheap.ai/docs/nl/api-reference/transcribe.md)
>
> `POST /v1/transcribe`
>
> Transcribeer een geüpload bestand als JSON, SRT of VTT.

> [card] [Projecttranscript exporteren](https://api-docs.voicecheap.ai/docs/nl/api-reference/project-transcript.md)
>
> `POST /v1/projects/{projectId}/transcript`
>
> Haal originele of vertaalde projecttranscripts op.

> [card] [Project aanmaken](https://api-docs.voicecheap.ai/docs/nl/api-reference/create-project.md)
>
> `POST /v1/projects`
>
> Upload een video- of audiobestand en start alleen de transcriptie.

> [card] [Vertaling starten](https://api-docs.voicecheap.ai/docs/nl/api-reference/translate.md)
>
> `POST /v1/translate`
>
> Upload een video- of audiobestand en start een vertaalproject.

> [card] [Project nasynchroniseren](https://api-docs.voicecheap.ai/docs/nl/api-reference/dub-project.md)
>
> `POST /v1/projects/{projectId}/dub`
>
> Synchroniseer een getranscribeerd project met uw eigen vertaalde SRT-bestand.

> [card] [Vertaalstatus ophalen](https://api-docs.voicecheap.ai/docs/nl/api-reference/translation-status.md)
>
> `GET /v1/translate/{projectId}/status`
>
> Controleer de status van een vertaalproject en haal resultaten op.

> [card] [Projectdetails ophalen](https://api-docs.voicecheap.ai/docs/nl/api-reference/project-details.md)
>
> `GET /v1/projects/{projectId}`
>
> Haal de vertaalde versiegeschiedenis, lipsynchronisatie-geschiedenis en projectstatus op.

> [card] [Project verwijderen](https://api-docs.voicecheap.ai/docs/nl/api-reference/delete-project.md)
>
> `DELETE /v1/translate/{projectId}`
>
> Verwijder een vertaalproject en de bijbehorende assets permanent.

## Vertaalworkflow

De typische workflow voor het vertalen van een video is:

```mermaid theme={null}
sequenceDiagram
    participant Client as Client
    participant API
    participant Processing as Verwerking

    Client->>API: POST /v1/translate (bestand + opties)
    API->>Processing: Vertaaltaak in wachtrij plaatsen
    API-->>Client: 201 (projectId)

    loop Status opvragen
        Client->>API: GET /v1/translate/{projectId}/status
        API-->>Client: status (processing/success/failed)
    end

    Note over Client: URL van vertaalde video downloaden wanneer de status "success" 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](https://api-docs.voicecheap.ai/docs/nl/api-reference/errors.md).

## HTTP-statuscodes

| Statuscode | Beschrijving |
| - | - |
| 200 | Succes |
| 201 | Aangemaakt – Een project of nasynchronisatie is gestart |
| 202 | Geaccepteerd - Volg de asynchrone actie met de aanvraag-ID |
| 400 | Bad Request - Ongeldige parameters |
| 401 | Unauthorized - Ongeldige of ontbrekende API-sleutel |
| 403 | Forbidden - Onvoldoende rechten of credits |
| 404 | Not Found - Bron bestaat niet |
| 409 | Conflict – De projectstatus staat het verzoek niet toe |
| 413 | Bestand te groot – De upload overschrijdt de limiet |
| 429 | Too Many Requests - Snelheidslimiet overschreden |
| 500 | Internal Server Error |
| 502 | Verwerkingsfout – De transcriptie kon niet worden voltooid |
| 503 | Dienst tijdelijk niet beschikbaar - Bewaar dezelfde aanvraag-ID en controleer de status voordat je opnieuw probeert |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.