Çeviri Görevi API
Çeviri Görevi Oluştur
Belge/dosya çevirisi için yeni bir çeviri görevi oluşturun.
- Tam adres
- https://dltranslator.com/api/v1/translation/create
- Doğrulama
- API Key'in Authorization istek başlığında iletilmesi gerekir
- Content-Type
- multipart/form-data
- Geçersiz format
- { "error": "Invalid API key." }
Dikkat Edilecek Hususlar
Görev oluşturulduğunda hemen bekleme kuyruğuna girer ve taskId döndürülür. Daha sonra görev sorgulama arayüzü aracılığıyla ilerleme, ücret ve indirme bağlantısı alınabilir.
Görev oluşturmak için hesap kredi bakiyesinin en az 2 credits olması gerekir. preview true olduğunda yalnızca önizleme oluşturulur ve önizleme kredisi ödenir.
glossary parametresi sözlük adına göre eşleşir, birden fazla sözlük belirtmek için aynı isimli birden fazla parametre gönderilebilir.
Örnek
1curl -X POST 'https://dltranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese' \
6--form 'outputFormat=MD' \
7--form 'bilingualMode=Horizontal' İstek Parametreleri
| Parametreler | Tür | Varsayılan | Açıklama | Örnek |
|---|---|---|---|---|
| *file | binary | - |
| bitcoin.pdf |
| *fromLang | String | - |
| English |
| *toLang | String | - |
| Simplified Chinese |
| model | String | - |
| - |
| fileDescription | String | - | Doküman açıklaması: ek bilgi sağlayarak çeviri kalitesini artırır, örneğin ek doküman arka plan bilgileri ve diğer çeviri gereksinimleri ekleme gibi | - |
| glossary | String | - | Çeviri sırasında kullanılan terminoloji tablosu adı | - |
| preview | Boolean | false | Yalnızca önizleme oluşturulsun mu. Yalnızca önizleme oluşturulurken, doküman çevirisinin önizlemesini oluşturmak için 2 credits ödeyerek | - |
| shouldTranslateImage | Boolean | false |
| - |
| forceOCR | Boolean | false | Belge içeriğini tanımak için OCR kullanımı zorunlu tutulsun mu. Etkinleştirildiğinde resim çevirisi de aynı anda etkinleştirilecektir. | - |
| shouldTranslateFileName | Boolean | true | Dosya adları çevrilsin mi | - |
| strictSourceLanguageCheck | Boolean | false | Sadece kaynak dil olarak algılanan metinler çevrilsin mi. Etkinleştirildiğinde kaynak dil olmayan içerikler daha katı filtrelenecek ve maliyet hesaplamasında da daha katı katsayılar kullanılacaktır. | - |
| outputFormat | String | - | Çıktı formatı. MD iletildiğinde Markdown çevirisi oluşturulmaya çalışılır. | MD |
| bilingualMode | String | Horizontal | İki dilli dosya düzen yönü. Horizontal solda-sağda karşılaştırmayı, Vertical üstte-altta karşılaştırmayı ifade eder. | Horizontal |
| password | String | - | PDF dosyasının açma şifresi | - |
| ignoreComments | Boolean | false | DOCX, PPTX ve XLSX dosyalarındaki yorumlar göz ardı edilsin mi | - |
| ignoreNotes | Boolean | false | PPTX dosyalarındaki notlar göz ardı edilsin mi | - |
| ignoreHeadersAndFooters | Boolean | false | DOCX dosyalarındaki üstbilgi ve altbilgi göz ardı edilsin mi | - |
| ignoreHidden | Boolean | false | PPTX dosyalarındaki gizli sayfalar göz ardı edilsin mi | - |
| ignoreMasters | Boolean | false | PPTX dosyalarındaki ana şablon metni göz ardı edilsin mi | - |
| ignoreSheetNames | Boolean | false | XLSX tablo adları çevrilmesin mi | - |
| extractTextRegExpPattern | String | - |
| - |
| extractTextRegExpFlags | String | - |
| - |
| allowFlip | Boolean | true | Sağdan sola dillerde sayfa düzeninin ters çevrilmesine izin verilip verilmeyeceği. false iletildiğinde resim ters çevirme de kapatılır. | - |
| allowFlipImage | Boolean | true | Sağdan sola dillerde resim içeriğinin ters çevrilmesine izin verilip verilmeyeceği. | - |
| webhookUrl | String | - | Durum güncellemesi için geri çağırma URL'si, geri çağırma içeriği şunları içerir: {taskId, progress, status} | - |
Yanıt
| Parametreler | Tür | Varsayılan | Açıklama | Örnek |
|---|---|---|---|---|
| taskId | String | - | Görev Kimliği | - |
Yaygın Hatalar
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
402 Insufficient credits balance.
The account does not have enough credits to create the task.
400 Missing required parameter: fromLang.
Provide fromLang using a language returned by /api/v1/languages.
400 Missing required parameter: toLang.
Provide toLang using a language returned by /api/v1/languages.
400 Invalid fromLang: [language]. Use a language returned by /api/v1/languages.
The provided source language is not supported.
400 Invalid toLang: [language]. Use a language returned by /api/v1/languages.
The provided target language is not supported.
400 Missing required file upload: file.
Upload the source document in the file form field.
404 Glossary "[name]" not found.
The specified glossary does not exist or does not belong to the current API account.