DeepL (förhandsversion)

DeepL-anslutningsappen ger programmatisk åtkomst till DeepL:s maskinöversättningsteknik, vilket gör det möjligt att ge översättningsfunktioner av hög kvalitet direkt till dina webbplatser och program. Kontakta oss om du vill utveckla ett DeepL-plugin-program för ditt CAT-verktyg.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster	Class	Regioner
Copilot Studio	Premie	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Logiska appar	Norm	Alla Logic Apps-regioner utom följande:      – Azure Government-regioner      – Regioner i Azure Kina      - US Department of Defense (DoD)
Power Apps	Premie	Alla Power Apps-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Power Automate	Premie	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)

Kontakt
Namn	Tim Cadenbach
URL	https://github.com/deejaytc
E-postmeddelande	tim.cadenbach@deepl.com

Metadata för anslutningsprogram
Utgivare	DeepL
Webbplats	https://www.deepl.com/
Sekretesspolicy	https://www.deepl.com/privacy/
Kategorier	Uppgifter

DeepL:s uppdrag är att övervinna språkbarriärer och föra kulturer närmare varandra. För att uppnå det uppdraget använder vi vår expertis inom artificiell intelligens och neurala nätverk för att skapa tekniker som gör kommunikationen snabbare, bättre och enklare.

Med DeepL API Connector kan du använda DeepL-API:et i dina flöden. Översätt text eller dokument i farten eller hantera dina ordlistor. Alla funktioner som vi erbjuder med DeepL API kan också användas i Power Automate.

Krav och autentiseringsuppgifter

Om du vill använda anslutningsappen krävs en kostnadsfri DeepL API- eller Pro-prenumeration. Du kan registrera dig här. När du har registrerat dig hittar du din autentiseringsnyckel på fliken "Konto" i ditt DeepL API-konto.

När du skapar ditt flöde uppmanas du att ange om du har en kostnadsfri eller Pro-plan. Detta måste väljas i enlighet med detta.

Kom igång med anslutningsappen

Börja lägga till ett nytt flöde som vanligt och välj en av de tillgängliga DeepL-åtgärderna. Om du gör det för första gången uppmanas du att lägga till viss anslutningsinformation enligt nedan:

Välj prisplanen i enlighet med detta och lägg till din API-nyckel. Namnet kan vara vad du vill. Bekräfta steget med "Skapa" och därefter kan du använda anslutningen för alla andra tillgängliga åtgärder.

Kända problem och begränsningar

• Vi kan inte identifiera din prisplan automatiskt. Du måste välja mellan Kostnadsfri och Pro själv när du konfigurerar ett flöde för första gången.

• Vissa slutpunkter stöder inte JSON utan fungerar bara med URLFormEncoded-innehåll, och även om anslutningsappen har en intern lösning kanske detta inte alltid fungerar för alla.
  Hej, hur mår du?

Vanliga fel och åtgärder

• HTTP 429 – Ett 429-fel kan orsakas av flera problem: antingen försökte du anropa API:et för ofta eller så kan det finnas ett tillfälligt problem på vår sida. Den allmänna rekommendationen är att använda en exponentiell back-off-metod och försöka anropa igen. Exponentiell säkerhetskopiering implementeras inte av själva anslutningsappen.

• HTTP 400 – Något var fel med anropet, nyttolasten eller parametrarna som användes.

• HTTP 456 – Kvoten har överskridits. Om du får ett 456-fel har din kontogräns för tecken nåtts och du måste antingen vänta till nästa användningsperiod eller uppgradera ditt konto. Om du är en kostnadsfri API-användare kan du uppgradera på fliken "Plan" för ditt konto.

Vanliga frågor

• Vad är skillnaden mellan DeepL API Free och Pro-planer?

DeepL API Free är en variant av vår DeepL API Pro-plan som låter dig översätta upp till 500 000 tecken per månad utan kostnad.

För mer avancerade behov erbjuder DeepL API Pro-planen följande ytterligare fördelar:

1. Maximal datasäkerhet (dina texter tas bort omedelbart efter översättningen)

2. Ingen volymbegränsning för antalet tecken som du kan översätta per månad (en faktureringsmodell baserat på ett fast pris på 4,99 euro per månad + användningsbaserade kostnader på 0,00002 euro per översatt tecken)

3. Prioriterad körning av översättningsbegäranden

Hej, hur mår du?

Läs mer i vårt hjälpcenter.

• Vad händer om jag har nått min teckengräns för den kostnadsfria planen?

Om du har nått din månatliga teckengräns för Deepl API Free måste du vänta till nästa användningsperiod (dvs. månad) för att kunna använda API:et igen. Du kan också överväga att uppgradera till en Pro API-prenumeration på fliken "Plan" för ditt konto.

• Finns det något sätt att begränsa mina användningsbaserade kostnader som Pro-prenumerant på?

Ja, du kan aktivera funktionen kostnadskontroll från fliken "Plan" för ditt Pro-konto.. Läs mer om kostnadskontroll i vårt hjälpcenter.

• Vilka funktioner är tillgängliga med anslutningsappen?

Allt du kan göra med vårt API kan också göras med hjälp av anslutningsappen. Du kan titta här om du vill se alla funktioner som stöds och ytterligare dokumentation om parametrar och information.

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

Standardinställning	Parametrar för att skapa anslutning.	Alla regioner	Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn	Typ	Description	Krävs
API-nyckel	securestring	Din API-nyckel, du kan hämta din nyckel från instrumentpanelen för ditt konto. Krävs för kostnadsfria användare och Pro-användare.	Sann
Planval	snöre	Välj wether du är en kostnadsfri eller pro-användare av API:et	Sann

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	100	60 sekunder

Åtgärder

Hämta ordlisteinformation	Hämta metainformation för en enda ordlista och utelämna ordlisteposterna.
Hämta ordlisteposter	Visa en lista över posterna i en enda ordlista i det format som anges av Accept rubriken.
Hämta språk som stöds	Hämta listan över språk som för närvarande stöds för översättning, antingen som käll- eller målspråk.
Kontrollera användning och gränser	Hämta användningsinformation inom den aktuella faktureringsperioden tillsammans med motsvarande kontogränser.
Kontrollera dokumentstatus	Hämta den aktuella statusen för en dokumentöversättningsprocess.
Ladda ned översatt dokument	När statusen för dokumentöversättningsprocessen är donekan resultatet laddas ned.
Ladda upp och översätta ett dokument	Det här anropet laddar upp ett dokument och köar det för översättning.
Listspråkpar som stöds av ordlistor	Hämta listan över språkpar som stöds av ordlistefunktionen.
Skapa en ordlista	Skapa en ordlista
Ta bort en ordlista	Tar bort den angivna ordlistan.
Visa en lista över alla ordlistor	Visa en lista över alla ordlistor och deras metainformation, men inte ordlisteposterna.
Översätt text, använd detta för allmän textöversättning	Lägg till en eller flera textposter att översätta, om flera används anses de vara samma kontext.

Hämta ordlisteinformation

Åtgärds-ID:

GetGlossary

Hämta metainformation för en enda ordlista och utelämna ordlisteposterna.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Ordliste-ID	glossary_id	True	string	Ett unikt ID som tilldelats ordlistan

Returer

Body

Glossary

Hämta ordlisteposter

Åtgärds-ID:

GetGlossaryEntries

Visa en lista över posterna i en enda ordlista i det format som anges av Accept rubriken.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Ordliste-ID	glossary_id	True	string	Ett unikt ID som tilldelats ordlistan
Format	Accept		string	Stöder för närvarande endast text/tab-separated-values

Hämta språk som stöds

Åtgärds-ID:

GetLanguages

Hämta listan över språk som för närvarande stöds för översättning, antingen som käll- eller målspråk.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Typ	type		string	Anger om käll- eller målspråk ska visas

Returer

Name	Sökväg	Typ	Description
		array of object
Språk	language	string	Språkkoden för det angivna språket.
name	name	string	Namnet på språket på engelska.
supports_formality	supports_formality	boolean	Anger formalitetsstöd i händelse av en målspråkslista.

Kontrollera användning och gränser

Åtgärds-ID:

GetUsage

Hämta användningsinformation inom den aktuella faktureringsperioden tillsammans med motsvarande kontogränser.

Returer

Name	Sökväg	Typ	Description
character_count	character_count	integer	Tecken som översatts hittills under den aktuella faktureringsperioden.
character_limit	character_limit	integer	Aktuellt maximalt antal tecken som kan översättas per faktureringsperiod.
document_limit	document_limit	integer	Dokument som översatts hittills under den aktuella faktureringsperioden.
document_count	document_count	integer	Aktuellt maximalt antal dokument som kan översättas per faktureringsperiod.
team_document_limit	team_document_limit	integer	Dokument som översatts av alla användare i teamet hittills under den aktuella faktureringsperioden.
team_document_count	team_document_count	integer	Aktuellt maximalt antal dokument som kan översättas av teamet per faktureringsperiod.

Kontrollera dokumentstatus

Åtgärds-ID:

GetDocumentStatus

Hämta den aktuella statusen för en dokumentöversättningsprocess.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Dokument-ID	document_id	True	string	Dokument-ID:t skickades till klienten när dokumentet laddades upp
Dokumentnyckel	document_key	True	string	Krypteringsnyckeln skickades till klienten när dokumentet laddades upp

Returer

Name	Sökväg	Typ	Description
document_id	document_id	string	Ett unikt ID som tilldelats det uppladdade dokumentet och den begärda översättningsprocessen. Samma ID som användes när översättningsstatus begärdes.
status	status	string	En kort beskrivning av tillståndet som dokumentöversättningsprocessen för närvarande befinner sig i.
seconds_remaining	seconds_remaining	integer	Beräknat antal sekunder tills översättningen är klar. Den här parametern ingår bara medan status är "translating".
billed_characters	billed_characters	integer	Antalet tecken som faktureras till ditt konto.
error_message	error_message	string	En kort beskrivning av felet, om det är tillgängligt. Observera att innehållet kan komma att ändras. Den här parametern kan inkluderas om ett fel uppstod under översättningen.

Ladda ned översatt dokument

Åtgärds-ID:

DownloadDocument

När statusen för dokumentöversättningsprocessen är donekan resultatet laddas ned.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Dokument-ID	document_id	True	string	Dokument-ID:t skickades till klienten när dokumentet laddades upp
Dokumentnyckel	document_key	True	string	Krypteringsnyckeln skickades till klienten när dokumentet laddades upp

Returer

response

binary

Ladda upp och översätta ett dokument

Åtgärds-ID:

TranslateDocument

Det här anropet laddar upp ett dokument och köar det för översättning.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Källspråk	source_lang		string	Språk för den text som ska översättas
Målspråk	target_lang	True	string	Det språk som texten ska översättas till
File	file	True	file	Filen som ska översättas (.docx,.pptx,.pdf,.htm,.html,.txt)
Filnamn	filename		string	Namnet på den uppladdade filen
Formalitet	formality		string	Om man ska luta sig mot ett formellt eller informellt språk.
Ordliste-ID	glossary_id		string	Ett unikt ID som tilldelats en ordlista

Returer

Name	Sökväg	Typ	Description
document_id	document_id	string	Ett unikt ID som tilldelats det uppladdade dokumentet och översättningsprocessen.
document_key	document_key	string	En unik nyckel som används för att kryptera det uppladdade dokumentet samt den resulterande översättningen på serversidan.

Listspråkpar som stöds av ordlistor

Åtgärds-ID:

ListGlossaryLanguages

Hämta listan över språkpar som stöds av ordlistefunktionen.

Returer

Name	Sökväg	Typ	Description
supported_languages	supported_languages	array of object	Listan över språk som stöds
source_lang	supported_languages.source_lang	string	Det språk där källtexterna i ordlistan anges.
target_lang	supported_languages.target_lang	string	Det språk där måltexterna i ordlistan anges.

Skapa en ordlista

Åtgärds-ID:

CreateGlossary

Skapa en ordlista

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Namn	name	True	string	Namn som ska associeras med ordlistan
Källspråk	source_lang	True	string	Det språk där källtexterna i ordlistan anges
Målspråk	target_lang	True	string	Det språk där måltexterna i ordlistan anges
Poster	entries	True	string	Ordlisteposterna i det format som anges i parametern Entries Format
Format för poster	entries_format	True	string	tsv (standard) – tabbavgränsade värden – csv kommaavgränsade värden

Returer

Body

Glossary

Ta bort en ordlista

Åtgärds-ID:

DeleteGlossary

Tar bort den angivna ordlistan.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Ordliste-ID	glossary_id	True	string	Ett unikt ID som tilldelats ordlistan

Visa en lista över alla ordlistor

Åtgärds-ID:

ListGlossaries

Visa en lista över alla ordlistor och deras metainformation, men inte ordlisteposterna.

Returer

Name	Sökväg	Typ	Description
Ordlistor	glossaries	array of Glossary

Översätt text, använd detta för allmän textöversättning

Åtgärds-ID:

TranslateText

Lägg till en eller flera textposter att översätta, om flera används anses de vara samma kontext.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Text som ska översättas	text	True	array	Text som ska översättas. Endast UTF-8-kodad oformaterad text stöds
Källspråk	source_lang		string	Språk för den text som ska översättas
Målspråk	target_lang	True	string	Det språk som texten ska översättas till
Dela meningar	split_sentences		string	Om indata ska delas upp i meningar
Bevara formatering	preserve_formatting		string	Om den ursprungliga formateringen ska respekteras
Formalitet	formality		string	Om man ska luta sig mot ett formellt eller informellt språk.
Ordliste-ID	glossary_id		string	Ange ordlistan som ska användas för översättningen
Tagghantering	tag_handling		string	Anger vilken typ av taggar som ska hanteras
Taggar som inte delas upp	non_splitting_tags		string	Kommaavgränsad lista över XML-taggar som aldrig delar meningar
Dispositionsidentifiering	outline_detection		string	0 inaktiverar automatisk identifiering av XML-struktur
Dela upp taggar	splitting_tags		string	Kommaavgränsad lista över XML-taggar som alltid orsakar delningar
Ignorera taggar	ignore_tags		string	Kommaavgränsad lista över XML-taggar som anger att texten inte ska översättas

Returer

Name	Sökväg	Typ	Description
Översättningar	translations	array of object
detected_source_language	translations.detected_source_language	string	Det identifierade källspråket.
texten	translations.text	string	Den översatta texten.

Definitioner

OrdlistaId

Ett unikt ID som tilldelats en ordlista.

Ett unikt ID som tilldelats en ordlista.

string

Ordlista

Name	Sökväg	Typ	Description
glossary_id	glossary_id	GlossaryId	Ett unikt ID som tilldelats en ordlista.
name	name	string	Namn som är associerat med ordlistan.
redo	ready	boolean	Anger om den nyligen skapade ordlistan redan kan användas i translate begäranden. Om den skapade ordlistan ännu inte är klar måste du vänta och kontrollera statusen ready för ordlistan innan du använder den i en translate begäran.
source_lang	source_lang	GlossarySourceLanguage	Det språk där källtexterna i ordlistan anges.
target_lang	target_lang	GlossaryTargetLanguage	Det språk där måltexterna i ordlistan anges.
creation_time	creation_time	date-time	Ordlistans skapandetid i FORMATET ISO 8601-1:2019 (t.ex. 2021-08-03T14:16:18.329Z).
entry_count	entry_count	integer	Antalet poster i ordlistan.

GlossarySourceLanguage

Det språk där källtexterna i ordlistan anges.

Det språk där källtexterna i ordlistan anges.

string

OrdlistaTargetLanguage

Det språk där måltexterna i ordlistan anges.

Det språk där måltexterna i ordlistan anges.

string

binär

Det här är den grundläggande datatypen "binär".