Çeviri API
Belgelerinizi bir betik aracılığıyla Edgepedia Çeviri'ye gönderip çevirilerini alın. Çeviri sayfasındaki hizmetin aynısıdır; fiyatlar aynıdır ve ücret aynı kredi bakiyesinden düşülür.
Anahtar alma
Çeviri sayfasında bir anahtar oluşturun: giriş yapın, sağ üstteki hesap menünüzü açın ve API anahtarları bölümünde Oluştur'u seçin.
Her istekte anahtarı Authorization: Bearer ept_… olarak gönderin. Gizli tutun: anahtara sahip olan herkes kredilerinizi harcayabilir.
Fiyatlar
- Standart: 250 kelime başına 1 kredi (en az 1).
- Pro: 75 kelime başına 1 kredi (en az 2).
- Kaynak ve hedef dilin ikisi de İngilizce değilse fiyat iki katına çıkar.
- 100 kredi = 1 USD.
Çeviri başarısız olursa krediler iade edilir.
Uç noktalar
Temel URL: https://translate.edgepedia.ai. İstekler ve yanıtlar JSON biçimindedir; hata biçimi {"error": "…"} şeklindedir.
GET /api/v1/languages
Diller ve her dil için Pro'nun kullanılabilir olup olmadığı.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Kredi bakiyeniz.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
Çeviriyi başlatmadan fiyatını ve tahmini süresini verir. mode, standard veya pro olabilir.
Fiyat sorgusunda "source": "auto" da kullanılabilir: yanıtta, "source" içinde algılanan dil "detected": true ile belirtilir; ardından bu dil koduyla çeviri başlatılır.
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
Bir metnin veya en fazla 10 MB boyutunda bir .txt, .md, .docx ya da .pdf dosyasının çevirisini başlatın. Fiyat beklediğinizden farklıysa isteğin reddedilmesi (409) için "expect_credits" ekleyin. Tamamlanan çeviriyi aynı yanıtta almak için "wait" ekleyin (en fazla 120 saniye).
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
Çevirinin durumu (queued, running, done veya failed) ve tamamlandıysa çeviri metni. Başarısızsa nedeni belirtilir. Tamamlanan çeviri 30 gün boyunca alınabilir.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Dosya çevirisinin sonucu: .docx ve .pdf dosyaları için .docx, .txt ve .md dosyaları için metin.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
En yeniden eskiye doğru sıralanmış çevirileriniz; en fazla 50 çeviri.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Durum kodları
| Kod | Anlamı |
|---|---|
| 200 | OK; wait ile başlatılan çeviri tamamlandı veya başarısız oldu. |
| 202 | Başlatıldı veya wait süresi dolduğunda hâlâ devam ediyor. |
| 400 | İstek, gönderildiği haliyle çevrilemiyor; nedeni hatada belirtilir. |
| 401 | Anahtar eksik, tanınmıyor veya iptal edilmiş. |
| 402 | Yeterli kredi yok. |
| 404 | Hesabınızda böyle bir çeviri yok. |
| 409 | Fiyat, beklediğiniz expect_credits değil; ücret alınmadı. |
| 413 | Dosyanın boyutu 10 MB sınırını aşıyor. |
| 429 | Bir dakika içinde 60'tan fazla istek gönderildi; Retry-After başlığındaki süre kadar bekleyip tekrar deneyin. |