DeepL (preview)
De DeepL-connector biedt programmatische toegang tot de technologie voor automatische vertaling van DeepL, waardoor het mogelijk is om vertaalmogelijkheden van hoge kwaliteit rechtstreeks naar uw websites en toepassingen te brengen. Als u een DeepL-invoegtoepassing voor uw CAT-tool wilt ontwikkelen, neem dan contact met ons op.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Tim Cadbach |
| URL | https://github.com/deejaytc |
| E-mailen | tim.cadenbach@deepl.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | DeepL |
| Webpagina | https://www.deepl.com/ |
| Privacybeleid | https://www.deepl.com/privacy/ |
| Categorieën | Gegevens |
DeepL's missie is om taalbarrières te overwinnen en culturen dichter bij elkaar te brengen. Om die missie te bereiken, gebruiken we onze expertise in kunstmatige intelligentie en neurale netwerken om technologieën te creëren die communicatie sneller, beter en gemakkelijker maken.
Met de DeepL API-connector kunt u de DeepL-API in uw stromen gebruiken. Tekst of documenten snel vertalen of uw woordenlijsten beheren. Alle functionaliteit die we bieden met DeepL API kan ook worden gebruikt in Power Automate.
Vereisten en referenties
Voor het gebruik van de connector is een DeepL API Free- of Pro-abonnement vereist. U kunt zich hier registreren. Nadat u zich hebt geregistreerd, kunt u uw verificatiesleutel vinden op het tabblad Account in uw DeepL API-account.
Tijdens het maken van uw stroom wordt u gevraagd of u een gratis of Pro-abonnement hebt. Dit moet dienovereenkomstig worden geselecteerd.
Aan de slag met uw connector
Begin met het toevoegen van een nieuwe stroom zoals gewoonlijk en kies een van de beschikbare DeepL-acties. Als u dit voor de eerste keer doet, wordt u gevraagd om enkele verbindingsgegevens toe te voegen, zoals hieronder wordt weergegeven: 
Kies het prijsplan dienovereenkomstig en voeg uw API-sleutel toe. De naam kan alles zijn wat u wilt. Bevestig de stap met Maken en daarna kunt u de verbinding gebruiken voor alle andere beschikbare acties.
Bekende problemen en beperkingen
Uw prijsplan kan niet automatisch worden gedetecteerd. U moet zelf kiezen tussen Gratis en Pro bij het instellen van een stroom voor de eerste keer.
Sommige eindpunten bieden geen ondersteuning voor JSON, maar werken alleen met URLFormEncoded-inhoud en hoewel de connector een interne tijdelijke oplossing heeft, werkt dit mogelijk niet altijd voor iedereen.
Veelvoorkomende fouten en oplossingen
HTTP 429 - Een 429-fout kan worden veroorzaakt door meerdere problemen: u probeert de API te vaak aan te roepen of er is mogelijk een tijdelijk probleem aan onze kant. De algemene aanbeveling is om een exponentiële back-off-benadering te gebruiken en de aanroep opnieuw uit te voeren. Exponentiële back-off wordt niet door de connector zelf geïmplementeerd.
HTTP 400: er is iets misgegaan met uw aanroep, nettolading of parameters die worden gebruikt.
HTTP 456 - Quotum overschreden. Als u een 456-fout krijgt, is uw accountlimiet voor tekens bereikt en moet u wachten tot de volgende gebruiksperiode of uw account upgraden. Als u een gratis API-gebruiker bent, kunt u upgraden op het tabblad Abonnement van uw account.
Veelgestelde vragen
- Wat is het verschil tussen DeepL API Free- en Pro-abonnementen?
DeepL API Free is een variant van ons DeepL API Pro-abonnement waarmee u gratis maximaal 500.000 tekens per maand kunt vertalen.
Voor meer geavanceerde behoeften biedt het DeepL API Pro-plan de volgende extra voordelen:
Maximale gegevensbeveiliging (uw teksten worden direct na de vertaling verwijderd)
Geen volumebeperking voor het aantal tekens dat u per maand kunt vertalen (een factureringsmodel op basis van een vaste prijs van € 4,99 per maand + kosten op basis van gebruik van € 0,00002 per vertaald teken)
Prioriteitsuitvoering van vertaalaanvragen
Meer informatie vindt u in ons Helpcentrum.
- Wat gebeurt er als ik mijn tekenlimiet voor het gratis abonnement heb bereikt?
Als u de maandelijkse tekenlimiet voor Deepl API Free hebt bereikt, moet u wachten tot de volgende gebruiksperiode (dat wil bijvoorbeeld maand) om de API opnieuw te kunnen gebruiken. U kunt ook overwegen om een upgrade uit te voeren naar een Pro API-abonnement op het tabblad Plan van uw account.
- Is er als Pro-abonnee een manier om mijn kosten op basis van gebruik te beperken?
Ja, u kunt de functie kostenbeheer activeren op het tabblad Plan van uw Pro-account.. Meer informatie over kostenbeheer vindt u in ons Helpcentrum.
- Welke functionaliteit is beschikbaar met behulp van de connector?
Alles wat u momenteel met onze API kunt doen, kan ook worden gedaan met behulp van de connector. U kunt hier alle ondersteunde functionaliteit en aanvullende documentatie over parameters en details bekijken.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| API-sleutel | beveiligde string | Uw API-sleutel, u kunt uw sleutel ophalen uit uw accountdashboard. Vereist voor gratis en Pro-gebruikers. | Klopt |
| Selectie plannen | touw | Selecteer wether u een gratis of pro-gebruiker van de API bent | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Alle woordenlijsten weergeven |
Geef alle woordenlijsten en de bijbehorende meta-informatie weer, maar niet de woordenlijstvermeldingen. |
| Documentstatus controleren |
De huidige status van een documentomzettingsproces ophalen. |
| Een document uploaden en vertalen |
Met deze aanroep wordt een document geüpload en in de wachtrij geplaatst voor vertaling. |
| Een woordenlijst maken |
Een woordenlijst maken |
| Een woordenlijst verwijderen |
Hiermee verwijdert u de opgegeven woordenlijst. |
| Gebruik en limieten controleren |
Gebruiksgegevens ophalen binnen de huidige factureringsperiode, samen met de bijbehorende accountlimieten. |
| Ondersteunde talen ophalen |
Haal de lijst met talen op die momenteel worden ondersteund voor vertaling, respectievelijk als bron- of doeltaal. |
| Taalparen weergeven die worden ondersteund door woordenlijsten |
Haal de lijst met taalparen op die worden ondersteund door de woordenlijstfunctie. |
| Tekst vertalen, dit gebruiken voor algemene tekstomzetting |
Voeg een of meerdere tekstitems toe om te vertalen, als er meerdere worden gebruikt als dezelfde context. |
| Vertaald document downloaden |
Zodra de status van het documentomzettingsproces is |
| Woordenlijstdetails ophalen |
Haal metagegevens op voor één woordenlijst en laat de woordenlijstvermeldingen weg. |
| Woordenlijstvermeldingen ophalen |
Vermeld de vermeldingen van één woordenlijst in de indeling die is opgegeven door de |
Alle woordenlijsten weergeven
Geef alle woordenlijsten en de bijbehorende meta-informatie weer, maar niet de woordenlijstvermeldingen.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Glossaria
|
glossaries | array of Glossary |
Documentstatus controleren
De huidige status van een documentomzettingsproces ophalen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Document-id
|
document_id | True | string |
De document-id is naar de client verzonden toen het document werd geüpload |
|
Documentsleutel
|
document_key | True | string |
De versleutelingssleutel is naar de client verzonden toen het document werd geüpload |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
document_id
|
document_id | string |
Een unieke id die is toegewezen aan het geüploade document en het aangevraagde vertaalproces. Dezelfde id die is gebruikt bij het aanvragen van de vertaalstatus. |
|
status
|
status | string |
Een korte beschrijving van de status waarin het documentomzettingsproces zich momenteel bevindt. |
|
seconds_remaining
|
seconds_remaining | integer |
Geschat aantal seconden totdat de vertaling is voltooid.
Deze parameter is alleen opgenomen terwijl |
|
billed_characters
|
billed_characters | integer |
Het aantal tekens dat wordt gefactureerd voor uw account. |
|
error_message
|
error_message | string |
Een korte beschrijving van de fout, indien beschikbaar. Houd er rekening mee dat de inhoud kan worden gewijzigd. Deze parameter kan worden opgenomen als er een fout is opgetreden tijdens de vertaling. |
Een document uploaden en vertalen
Met deze aanroep wordt een document geüpload en in de wachtrij geplaatst voor vertaling.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Brontaal
|
source_lang | string |
Taal van de tekst die moet worden vertaald |
|
|
Doeltaal
|
target_lang | True | string |
De taal waarin de tekst moet worden vertaald |
|
Bestand
|
file | True | file |
Het bestand dat moet worden vertaald (.docx,.pptx,.pdf,.htm,.html,.txt) |
|
Bestandsnaam
|
filename | string |
De naam van het geüploade bestand |
|
|
Formaliteit
|
formality | string |
Of u nu naar formele of informele taal wilt leunen. |
|
|
Woordenlijst-id
|
glossary_id | string |
Een unieke id die is toegewezen aan een woordenlijst |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
document_id
|
document_id | string |
Een unieke id die is toegewezen aan het geüploade document en het vertaalproces. |
|
document_key
|
document_key | string |
Een unieke sleutel die wordt gebruikt voor het versleutelen van het geüploade document en de resulterende vertaling aan de serverzijde. |
Een woordenlijst maken
Een woordenlijst maken
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naam
|
name | True | string |
Naam die moet worden gekoppeld aan de woordenlijst |
|
Brontaal
|
source_lang | True | string |
De taal waarin de bronteksten in de woordenlijst worden opgegeven |
|
Doeltaal
|
target_lang | True | string |
De taal waarin de doelteksten in de woordenlijst worden opgegeven |
|
Posten
|
entries | True | string |
De woordenlijstvermeldingen in de indeling die is opgegeven in de |
|
Indeling van vermeldingen
|
entries_format | True | string |
|
Retouren
- Body
- Glossary
Een woordenlijst verwijderen
Hiermee verwijdert u de opgegeven woordenlijst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Woordenlijst-id
|
glossary_id | True | string |
Een unieke id die is toegewezen aan de woordenlijst |
Gebruik en limieten controleren
Gebruiksgegevens ophalen binnen de huidige factureringsperiode, samen met de bijbehorende accountlimieten.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
character_count
|
character_count | integer |
Tekens die tot nu toe zijn vertaald in de huidige factureringsperiode. |
|
character_limit
|
character_limit | integer |
Huidig maximum aantal tekens dat per factureringsperiode kan worden vertaald. |
|
document_limit
|
document_limit | integer |
Documenten die tot nu toe zijn vertaald in de huidige factureringsperiode. |
|
document_count
|
document_count | integer |
Huidig maximum aantal documenten dat per factureringsperiode kan worden vertaald. |
|
team_document_limit
|
team_document_limit | integer |
Documenten die tot nu toe door alle gebruikers in het team zijn vertaald in de huidige factureringsperiode. |
|
team_document_count
|
team_document_count | integer |
Huidig maximum aantal documenten dat per factureringsperiode door het team kan worden vertaald. |
Ondersteunde talen ophalen
Haal de lijst met talen op die momenteel worden ondersteund voor vertaling, respectievelijk als bron- of doeltaal.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Typologie
|
type | string |
Hiermee stelt u in of bron- of doeltalen moeten worden vermeld |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
language
|
language | string |
De taalcode van de opgegeven taal. |
|
naam
|
name | string |
Naam van de taal in het Engels. |
|
supports_formality
|
supports_formality | boolean |
Geeft formaliteitsondersteuning aan in het geval van een vermelding in de doeltaal. |
Taalparen weergeven die worden ondersteund door woordenlijsten
Haal de lijst met taalparen op die worden ondersteund door de woordenlijstfunctie.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
supported_languages
|
supported_languages | array of object |
De lijst met ondersteunde talen |
|
source_lang
|
supported_languages.source_lang | string |
De taal waarin de bronteksten in de woordenlijst worden opgegeven. |
|
target_lang
|
supported_languages.target_lang | string |
De taal waarin de doelteksten in de woordenlijst worden opgegeven. |
Tekst vertalen, dit gebruiken voor algemene tekstomzetting
Voeg een of meerdere tekstitems toe om te vertalen, als er meerdere worden gebruikt als dezelfde context.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Te vertalen tekst
|
text | True | array |
Te vertalen tekst. Alleen met UTF-8 gecodeerde tekst zonder opmaak wordt ondersteund |
|
Brontaal
|
source_lang | string |
Taal van de tekst die moet worden vertaald |
|
|
Doeltaal
|
target_lang | True | string |
De taal waarin de tekst moet worden vertaald |
|
Zinnen splitsen
|
split_sentences | string |
Of de invoer moet worden gesplitst in zinnen |
|
|
Opmaak behouden
|
preserve_formatting | string |
Of de oorspronkelijke opmaak moet worden gerespecteerd |
|
|
Formaliteit
|
formality | string |
Of u nu naar formele of informele taal wilt leunen. |
|
|
Woordenlijst-id
|
glossary_id | string |
De woordenlijst opgeven die moet worden gebruikt voor de vertaling |
|
|
Afhandeling van tags
|
tag_handling | string |
Hiermee stelt u in welk soort tags moet worden verwerkt |
|
|
Niet-gesplitste tags
|
non_splitting_tags | string |
Door komma's gescheiden lijst met XML-tags die nooit zinnen splitsen |
|
|
Overzichtsdetectie
|
outline_detection | string |
|
|
|
Tags splitsen
|
splitting_tags | string |
Door komma's gescheiden lijst met XML-tags die altijd splitsingen veroorzaken |
|
|
Tags negeren
|
ignore_tags | string |
Door komma's gescheiden lijst met XML-tags die aangeven dat tekst niet moet worden vertaald |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Translations
|
translations | array of object | |
|
detected_source_language
|
translations.detected_source_language | string |
De gedetecteerde brontaal. |
|
Tekst
|
translations.text | string |
De vertaalde tekst. |
Vertaald document downloaden
Zodra de status van het documentomzettingsproces is done, kan het resultaat worden gedownload.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Document-id
|
document_id | True | string |
De document-id is naar de client verzonden toen het document werd geüpload |
|
Documentsleutel
|
document_key | True | string |
De versleutelingssleutel is naar de client verzonden toen het document werd geüpload |
Retouren
- response
- binary
Woordenlijstdetails ophalen
Haal metagegevens op voor één woordenlijst en laat de woordenlijstvermeldingen weg.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Woordenlijst-id
|
glossary_id | True | string |
Een unieke id die is toegewezen aan de woordenlijst |
Retouren
- Body
- Glossary
Woordenlijstvermeldingen ophalen
Vermeld de vermeldingen van één woordenlijst in de indeling die is opgegeven door de Accept koptekst.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Woordenlijst-id
|
glossary_id | True | string |
Een unieke id die is toegewezen aan de woordenlijst |
|
Formaat
|
Accept | string |
Ondersteunt momenteel alleen |
Definities
Woordenlijst-id
Een unieke id die is toegewezen aan een woordenlijst.
Een unieke id die is toegewezen aan een woordenlijst.
Glossary
| Name | Pad | Type | Description |
|---|---|---|---|
|
glossary_id
|
glossary_id | GlossaryId |
Een unieke id die is toegewezen aan een woordenlijst. |
|
naam
|
name | string |
Naam die is gekoppeld aan de woordenlijst. |
|
klaar
|
ready | boolean |
Geeft aan of de zojuist gemaakte woordenlijst al kan worden gebruikt in |
|
source_lang
|
source_lang | GlossarySourceLanguage |
De taal waarin de bronteksten in de woordenlijst worden opgegeven. |
|
target_lang
|
target_lang | GlossaryTargetLanguage |
De taal waarin de doelteksten in de woordenlijst worden opgegeven. |
|
creation_time
|
creation_time | date-time |
De aanmaaktijd van de woordenlijst in de ISO 8601-1:2019-indeling (bijvoorbeeld: |
|
entry_count
|
entry_count | integer |
Het aantal vermeldingen in de woordenlijst. |
WoordenlijstBronLanguage
De taal waarin de bronteksten in de woordenlijst worden opgegeven.
De taal waarin de bronteksten in de woordenlijst worden opgegeven.
WoordenlijstTargetLanguage
De taal waarin de doelteksten in de woordenlijst worden opgegeven.
De taal waarin de doelteksten in de woordenlijst worden opgegeven.
binair
Dit is het basisgegevenstype 'binair'.