---
title: "Een vertaling maken"
description: "Upload via de API een bestand en maak een vertaling die klaarstaat om te plannen. Gebruik daarvoor een tijdelijke upload, JSON-tekst, een HTTPS-URL of multipart-formuliergegevens."
canonical: "https://ai-glot.com/docs/nl/api/translations/create"
updated: "2026-10-12"
---

# Een vertaling maken

Vereist `batches:create`. Een vertaling maken kost niets: er worden pas credits gereserveerd wanneer je [een plan goedkeurt](/docs/api/translations/approve).

## Kies hoe je het bestand verstuurt

Kies de verzendmethode die past bij de opslaglocatie van het document en de mogelijkheden van je client.

| Transport             | Geschikt voor                                                                                   | Opmerkingen                                                                                                                                                                                              |
| --------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JSON met `upload_id`  | Een lokaal bestand dat via een [tijdelijke uploadsessie](/docs/api/uploads/create) is verstuurd | Gebruik dezelfde inloggegevens als voor het aanmaken van de sessie. Laat `filename` weg. Als je de vertaling opnieuw aanmaakt, krijg je de bestaande vertaling terug zonder dat de instructie verandert. |
| JSON met `content`    | Alle tekstformaten                                                                              | De bestandsinhoud zelf, als UTF-8-tekst. De eenvoudigste optie voor een agent die de inhoud al in het geheugen heeft.                                                                                    |
| JSON met `file_url`   | Een bestand dat al online staat                                                                 | Alleen HTTPS; het bestand wordt aan de serverzijde opgehaald. Omleidingen worden niet gevolgd, dus geef de uiteindelijke URL op.                                                                         |
| `multipart/form-data` | Lokale binaire bestanden, waaronder XLSX, DOCX, PPTX, PDF, IDML en ZIP                          | Verstuur de oorspronkelijke bytes in het veld `file`. Dit is de methode waarmee de CLI lokale bestanden verstuurt.                                                                                       |

`filename` is optioneel, maar wel handig om mee te sturen. De extensie bepaalt hoe het formaat wordt herkend. Zo worden identieke bytes anders verwerkt wanneer de bestandsnaam `strings.xml` is dan wanneer die `export.csv` is.

## Wat gebeurt er daarna?

Het antwoord bevat een `id`, dat je in volgende paden gebruikt als `batch_id`. Daarna volg je altijd dezelfde stappen:

1. [`POST /v1/batches/{batch_id}/plan`](/docs/api/translations/plan): beschrijf in je eigen woorden wat er vertaald moet worden.
2. [`POST /v1/batches/{batch_id}/approve`](/docs/api/translations/approve): gebruik credits en start de vertaling.
3. [`GET /v1/batches/{batch_id}`](/docs/api/translations/retrieve): vraag de status op tot de vertaling klaar is.
4. [`GET /v1/batches/{batch_id}/result`](/docs/api/translations/download): haal het resultaat op. Je krijgt een ondertekende link, niet het bestand zelf.

> **Info: Maximale bestandsgrootte verschilt per formaat**
>
> Voor elke formaattypegroep geldt een eigen limiet, van 4 MB tot 60 MB. Zie [Bestanden en formaten](/docs/platform/files-and-formats) voor de volledige tabel. Een bestand dat de limiet overschrijdt, wordt geweigerd met `file_too_large` voordat er bytes worden opgeslagen.