Çeviri Görevi API
Çeviri metni
Metni çevirin ve çeviri sonuçlarını eşzamanlı olarak geri gönderin.
- Tam adres
- https://dltranslator.com/api/v1/translation/translateTexts
- Doğrulama
- API Key'in Authorization istek başlığında iletilmesi gerekir
- Content-Type
- application/json
- Geçersiz format
- { "error": "Invalid API key." }
Dikkat Edilecek Hususlar
Bu arayüz, iletilen metni geçici olarak JSON belgesi olarak kaydeder ve senkron olarak işler, küçük hacimli metinlerin anlık çevirisi için uygundur.
Hesap kredi bakiyesinin en az 2 credits olması gerekir. Gerçek maliyet bakiyeyi aşarsa, arayüz taskId ve price döndürür ve bakiye yetersizliği bildirir.
Örnek
1curl -X POST 'https://dltranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "texts": [
6 "string"
7 ],
8 "fromLang": "[string]",
9 "toLang": "[string]"
10}'İstek Parametreleri
| Parametreler | Tür | Varsayılan | Açıklama | Örnek |
|---|---|---|---|---|
| *texts | String[] | - | Çevrilmesi gereken metin | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| 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 | - |
Yanıt
| Parametreler | Tür | Varsayılan | Açıklama | Örnek |
|---|---|---|---|---|
| taskId | String | - | Görev Kimliği | - |
| translatedTexts | String[] | - | Çevrilmiş metin | - |
| price | Integer | - | Tüm çeviri için gereken Credits sayısı | - |
| usedCredits | Integer | - | Çeviri görevinin kullandığı Credits sayısı | - |
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 translate the texts.
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 Missing required parameter: texts.
Provide a non-empty texts array.
400 Failed to translate texts.
The text translation task could not be processed.