DeepL (előzetes verzió)
A DeepL-összekötő programozott hozzáférést biztosít a DeepL gépi fordítási technológiájához, lehetővé téve a magas minőségű fordítási képességek közvetlen elérését a webhelyek és alkalmazások számára. Ha szeretne fejleszteni egy DeepL beépülő modult a CAT eszközéhez, kérjük, lépjen kapcsolatba velünk.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Régiók |
|---|---|---|
| Copilot Studio | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Logikai alkalmazások | Standard | Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD) |
| Power Alkalmazások | prémium | Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Power Automate | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Érintkezés | |
|---|---|
| Név | Tim Cadenbach |
| URL | https://github.com/deejaytc |
| tim.cadenbach@deepl.com |
| Összekötő metaadatai | |
|---|---|
| Kiadó | DeepL |
| Webhely | https://www.deepl.com/ |
| Adatvédelmi irányelvek | https://www.deepl.com/privacy/ |
| Kategóriák | Adat |
A DeepL küldetése, hogy leküzdje a nyelvi korlátokat, és közelebb hozza egymáshoz a kultúrákat. Ennek a küldetésnek a megvalósítása érdekében mesterséges intelligenciával és neurális hálózatokkal kapcsolatos szakértelmünket arra használjuk, hogy olyan technológiákat hozzunk létre, amelyek a kommunikációt gyorsabbá, jobbá és egyszerűbbé teszik.
A DeepL API-összekötő lehetővé teszi a DeepL API használatát a folyamatokban. Lefordíthatja a szöveget vagy dokumentumokat menet közben, vagy kezelheti a szószedeteket. A DeepL API-val kínált funkciók a Power Automate-ben is használhatók.
Előfeltételek > Hitelesítő adatok
Az összekötő használatához DeepL API Ingyenes vagy Pro-előfizetés szükséges. Itt regisztrálhat. A regisztráció után a hitelesítési kulcsot a DeepL API-fiók Fiók lapján találja.
A folyamat létrehozásakor a rendszer megkéri, hogy adja meg, hogy rendelkezik-e ingyenes vagy Pro csomaggal. Ezt ennek megfelelően kell kiválasztani.
Ismerkedés az összekötővel
Kezdje el hozzáadni az új folyamatot a szokásos módon, és válasszon egyet a rendelkezésre álló DeepL-műveletek közül. Ennek első lépéseként kérje meg, hogy adjon hozzá néhány kapcsolati adatot az alábbiak szerint: 
Ennek megfelelően válassza ki az árcsomagot, és adja hozzá az API-kulcsot. A név lehet bármi, amit szeretne. Erősítse meg a lépést a "Létrehozás" lehetőséggel, és ezt követően használhatja a kapcsolatot az összes elérhető művelethez.
Ismert problémák és korlátozások
Nem tudjuk automatikusan észlelni az árcsomagot. A folyamat első beállításakor saját maga kell választania a Free és a Pro között.
Egyes végpontok nem támogatják a JSON-t, de csak URLFormEncoded tartalommal működnek, és bár az összekötő belső kerülő megoldással rendelkezik, ez nem mindig működik mindenki számára.
Gyakori hibák és jogorvoslatok
HTTP 429 – A 429-es hibát több probléma is okozhatja: vagy túl gyakran próbálta meghívni az API-t, vagy ideiglenes probléma merülhet fel a végén. Az általános javaslat az, hogy exponenciális visszatartási megközelítést használjon, és próbálkozzon újra a hívással. Az exponenciális visszalépést maga az összekötő nem valósítja meg.
HTTP 400 – Hiba történt a hívással, a hasznos adatokkal vagy a használt paraméterekkel.
HTTP 456 – Túllépte a kvótát. Ha 456-os hibaüzenet jelenik meg, elérte a fiók karakterekre vonatkozó korlátját, és vagy várnia kell a következő használati időszakig, vagy frissítenie kell a fiókját. Ha Ön ingyenes API-felhasználó, a fiók "Csomag" lapján frissíthet.
GYIK
- Mi a különbség a DeepL API Free és a Pro csomagok között?
A DeepL API Free a DeepL API Pro csomag egyik változata, amellyel havonta akár 500 000 karaktert is lefordíthat ingyenesen.
A speciálisabb igényekhez a DeepL API Pro-csomag a következő további előnyöket kínálja:
Maximális adatbiztonság (a szövegek közvetlenül a fordítás után törlődnek)
Nincs mennyiségi korlátozás a havonta lefordítható karakterek számára (a havi fix 4,99 eurós fix áron alapuló számlázási modell + lefordított karakterenként 0,00002 € használatalapú költség)
Fordítási kérelmek rangsorolása
További információ a súgóközpontban.
- Mi történik, ha elértem az ingyenes csomagra vonatkozó karakterkorlátomat?
Ha elérte a havi karakterkorlátot a Deepl API Free-ben, a következő használati időszakig (azaz hónapig) várnia kell, hogy újra használni tudja az API-t. Másik lehetőségként érdemes lehet pro API-előfizetésre frissíteni a fiók "Csomag" lapján.
- Pro-előfizetőként van mód a használatalapú költségek korlátozására?
Igen, a Költségkezelés funkciót a Pro-fiók "Terv" lapján aktiválhatja. További információ a költségszabályozásról a súgóközpontban.
- Mely funkciók érhetők el az összekötő használatával?
Az API-val jelenleg elvégezhető műveletek az összekötővel is elvégezhetők. Itt tekintheti meg az összes támogatott funkciót, valamint a paraméterekkel és részletekkel kapcsolatos további dokumentációt.
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Alapértelmezett | A kapcsolat létrehozásának paraméterei. | Minden régió | Nem osztható meg |
Alapértelmezett
Alkalmazható: Minden régió
A kapcsolat létrehozásának paraméterei.
Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.
| Név | Típus | Description | Kötelező |
|---|---|---|---|
| API-kulcs | securestring | Az API-kulcs lekérheti a kulcsot a fiók irányítópultjáról. Ingyenes és Pro-felhasználók számára szükséges. | True |
| Kijelölés megtervezve | karakterlánc | Válassza ki, hogy ön az API ingyenes vagy profi felhasználója-e | True |
Szabályozási korlátok
| Name | Hívások | Megújítási időszak |
|---|---|---|
| API-hívások kapcsolatonként | 100 | 60 másodperc |
Műveletek
| Az összes szószedet listázása |
Sorolja fel az összes szószedetet és azok metainformációit, de a szószedet-bejegyzéseket nem. |
| Dokumentum feltöltése és fordítása |
Ez a hívás feltölt egy dokumentumot, és várólistára állítja a fordításhoz. |
| Dokumentum állapotának ellenőrzése |
Dokumentumfordítási folyamat aktuális állapotának lekérése. |
| Használat és korlátok ellenőrzése |
Kérje le a használati adatokat az aktuális számlázási időszakon belül a megfelelő fiókkorlátokkal együtt. |
| Lefordított dokumentum letöltése |
Miután a dokumentumfordítási folyamat állapota megtörtént |
| Szószedet létrehozása |
Szószedet létrehozása |
| Szószedet részleteinek lekérése |
Egyetlen szószedet metaadatainak lekérése a szószedetbejegyzések kihagyásával. |
| Szószedet törlése |
Törli a megadott szószedetet. |
| Szószedetbejegyzések lekérése |
Egyetlen szószedet bejegyzéseinek listázása a |
| Szószedetek által támogatott nyelvi párok listázása |
A szószedet funkció által támogatott nyelvi párok listájának lekérése. |
| Szöveg fordítása, használata általános szövegfordításhoz |
Adjon hozzá egy vagy több szövegbejegyzést a fordításhoz, ha több is van használatban, akkor az azonos környezetnek minősül. |
| Támogatott nyelvek lekérése |
Kérje le a fordításhoz jelenleg támogatott nyelvek listáját forrásnyelvként vagy célnyelvként. |
Az összes szószedet listázása
Sorolja fel az összes szószedetet és azok metainformációit, de a szószedet-bejegyzéseket nem.
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Szószedetek
|
glossaries | array of Glossary |
Dokumentum feltöltése és fordítása
Ez a hívás feltölt egy dokumentumot, és várólistára állítja a fordításhoz.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Forrásnyelv
|
source_lang | string |
A lefordítandó szöveg nyelve |
|
|
Célnyelv
|
target_lang | True | string |
Az a nyelv, amelyre a szöveget le kell fordítani |
|
File
|
file | True | file |
A lefordítandó fájl (.docx,.pptx,.pdf,.htm,.html,.txt) |
|
Fájlnév
|
filename | string |
A feltöltött fájl neve |
|
|
Formalitás
|
formality | string |
Legyen szó hivatalos vagy informális nyelvről. |
|
|
Szószedet azonosítója
|
glossary_id | string |
Egy szószedethez rendelt egyedi azonosító |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
document_id
|
document_id | string |
A feltöltött dokumentumhoz és a fordítási folyamathoz rendelt egyedi azonosító. |
|
document_key
|
document_key | string |
Egy egyedi kulcs, amely a feltöltött dokumentum és az eredményként kapott fordítás titkosítására szolgál a kiszolgálóoldalon. |
Dokumentum állapotának ellenőrzése
Dokumentumfordítási folyamat aktuális állapotának lekérése.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Dokumentumazonosító
|
document_id | True | string |
A dokumentumazonosítót a rendszer elküldte az ügyfélnek a dokumentum feltöltésekor |
|
Dokumentumkulcs
|
document_key | True | string |
A titkosítási kulcsot a rendszer elküldte az ügyfélnek a dokumentum feltöltésekor |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
document_id
|
document_id | string |
A feltöltött dokumentumhoz és a kért fordítási folyamathoz rendelt egyedi azonosító. Ugyanaz az azonosító, amelyet a fordítási állapot igényléséhez használt. |
|
állapot
|
status | string |
A dokumentumfordítási folyamat aktuális állapotának rövid leírása. |
|
seconds_remaining
|
seconds_remaining | integer |
A fordítás befejezéséig becsült másodpercek száma.
Ez a paraméter csak akkor jelenik meg, ha |
|
billed_characters
|
billed_characters | integer |
A fiókba számlázott karakterek száma. |
|
error_message
|
error_message | string |
A hiba rövid leírása, ha elérhető. Vegye figyelembe, hogy a tartalom változhat. Ez a paraméter akkor is szerepelhet, ha hiba történt a fordítás során. |
Használat és korlátok ellenőrzése
Kérje le a használati adatokat az aktuális számlázási időszakon belül a megfelelő fiókkorlátokkal együtt.
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
character_count
|
character_count | integer |
Az aktuális számlázási időszakban eddig lefordított karakterek. |
|
character_limit
|
character_limit | integer |
A számlázási időszakonként lefordítható karakterek aktuális maximális száma. |
|
document_limit
|
document_limit | integer |
Az aktuális számlázási időszakban eddig lefordított dokumentumok. |
|
document_count
|
document_count | integer |
A számlázási időszakonként lefordítható dokumentumok aktuális maximális száma. |
|
team_document_limit
|
team_document_limit | integer |
A csapat összes felhasználója által lefordított dokumentumok az aktuális számlázási időszakban. |
|
team_document_count
|
team_document_count | integer |
A csapat által lefordítható dokumentumok aktuális maximális száma számlázási időszakonként. |
Lefordított dokumentum letöltése
Miután a dokumentumfordítási folyamat állapota megtörtént done, az eredmény letölthető.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Dokumentumazonosító
|
document_id | True | string |
A dokumentumazonosítót a rendszer elküldte az ügyfélnek a dokumentum feltöltésekor |
|
Dokumentumkulcs
|
document_key | True | string |
A titkosítási kulcsot a rendszer elküldte az ügyfélnek a dokumentum feltöltésekor |
Válaszok
- response
- binary
Szószedet létrehozása
Szószedet létrehozása
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Név
|
name | True | string |
A szószedethez társítandó név |
|
Forrásnyelv
|
source_lang | True | string |
Az a nyelv, amelyben a szószedetben szereplő forrásszövegek meg vannak adva |
|
Célnyelv
|
target_lang | True | string |
Az a nyelv, amelyben a szószedetben szereplő célszövegek meg vannak adva |
|
Bejegyzések
|
entries | True | string |
A paraméterben |
|
Bejegyzések formátuma
|
entries_format | True | string |
|
Válaszok
- Törzs
- Glossary
Szószedet részleteinek lekérése
Egyetlen szószedet metaadatainak lekérése a szószedetbejegyzések kihagyásával.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Szószedet azonosítója
|
glossary_id | True | string |
A szószedethez rendelt egyedi azonosító |
Válaszok
- Törzs
- Glossary
Szószedet törlése
Törli a megadott szószedetet.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Szószedet azonosítója
|
glossary_id | True | string |
A szószedethez rendelt egyedi azonosító |
Szószedetbejegyzések lekérése
Egyetlen szószedet bejegyzéseinek listázása a Accept fejléc által megadott formátumban.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Szószedet azonosítója
|
glossary_id | True | string |
A szószedethez rendelt egyedi azonosító |
|
Formátum
|
Accept | string |
Jelenleg csak a |
Szószedetek által támogatott nyelvi párok listázása
A szószedet funkció által támogatott nyelvi párok listájának lekérése.
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
supported_languages
|
supported_languages | array of object |
A támogatott nyelvek listája |
|
source_lang
|
supported_languages.source_lang | string |
Az a nyelv, amelyben a szószedetben szereplő forrásszövegek meg vannak adva. |
|
target_lang
|
supported_languages.target_lang | string |
Az a nyelv, amelyben a szószedetben szereplő célszövegek meg vannak adva. |
Szöveg fordítása, használata általános szövegfordításhoz
Adjon hozzá egy vagy több szövegbejegyzést a fordításhoz, ha több is van használatban, akkor az azonos környezetnek minősül.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Lefordítandó szöveg
|
text | True | array |
Lefordítandó szöveg. Csak UTF-8 kódolású egyszerű szöveg támogatott |
|
Forrásnyelv
|
source_lang | string |
A lefordítandó szöveg nyelve |
|
|
Célnyelv
|
target_lang | True | string |
Az a nyelv, amelyre a szöveget le kell fordítani |
|
Mondatok felosztása
|
split_sentences | string |
A bemenet felosztása mondatokra |
|
|
Formázás megőrzése
|
preserve_formatting | string |
Az eredeti formázás tiszteletben tartása |
|
|
Formalitás
|
formality | string |
Legyen szó hivatalos vagy informális nyelvről. |
|
|
Szószedet azonosítója
|
glossary_id | string |
Adja meg a fordításhoz használni kívánt szószedetet |
|
|
Címkekezelés
|
tag_handling | string |
Meghatározza, hogy milyen típusú címkéket kell kezelni |
|
|
Nem felosztott címkék
|
non_splitting_tags | string |
Olyan XML-címkék vesszővel tagolt listája, amelyek soha nem osztottak fel mondatokat |
|
|
Vázlatészlelés
|
outline_detection | string |
|
|
|
Címkék felosztása
|
splitting_tags | string |
Vesszővel tagolt XML-címkék listája, amelyek mindig felosztást okoznak |
|
|
Címkék figyelmen kívül hagyása
|
ignore_tags | string |
A lefordítani nem kívánt szöveget jelző XML-címkék vesszővel tagolt listája |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Fordítások
|
translations | array of object | |
|
detected_source_language
|
translations.detected_source_language | string |
Az észlelt forrásnyelv. |
|
SMS
|
translations.text | string |
A lefordított szöveg. |
Támogatott nyelvek lekérése
Kérje le a fordításhoz jelenleg támogatott nyelvek listáját forrásnyelvként vagy célnyelvként.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Típus
|
type | string |
Meghatározza, hogy a forrás- vagy célnyelvek szerepeljenek-e a listán |
Válaszok
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
|
array of object | ||
|
nyelv
|
language | string |
Az adott nyelv nyelvkódja. |
|
név
|
name | string |
A nyelv neve angol nyelven. |
|
supports_formality
|
supports_formality | boolean |
A formális támogatás jelölése célnyelvi lista esetén. |
Definíciók
Szószedetazonosító
Glossary
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
glossary_id
|
glossary_id | GlossaryId |
Egy szószedethez rendelt egyedi azonosító. |
|
név
|
name | string |
A szószedethez társított név. |
|
kész
|
ready | boolean |
Azt jelzi, hogy az újonnan létrehozott szószedet már használható-e a kérelmekben |
|
source_lang
|
source_lang | GlossarySourceLanguage |
Az a nyelv, amelyben a szószedetben szereplő forrásszövegek meg vannak adva. |
|
target_lang
|
target_lang | GlossaryTargetLanguage |
Az a nyelv, amelyben a szószedetben szereplő célszövegek meg vannak adva. |
|
creation_time
|
creation_time | date-time |
A szószedet létrehozási ideje ISO 8601-1:2019 formátumban (például: |
|
entry_count
|
entry_count | integer |
A szószedet bejegyzéseinek száma. |
GlossarySourceLanguage
Az a nyelv, amelyben a szószedetben szereplő forrásszövegek meg vannak adva.
Az a nyelv, amelyben a szószedetben szereplő forrásszövegek meg vannak adva.
GlossaryTargetLanguage
Az a nyelv, amelyben a szószedetben szereplő célszövegek meg vannak adva.
Az a nyelv, amelyben a szószedetben szereplő célszövegek meg vannak adva.
bináris
Ez a bináris alapszintű adattípus.