API tłumaczeń
Przesyłaj własne dokumenty do usługi Tłumaczenia Edgepedia za pomocą skryptu i otrzymuj ich tłumaczenia. To ta sama usługa co na stronie Tłumaczenia, w tych samych cenach, opłacana z tej samej puli kredytów.
Uzyskiwanie klucza
Utwórz klucz na stronie Tłumaczenia: zaloguj się, otwórz menu konta w prawym górnym rogu i wybierz „Utwórz” w sekcji „Klucze API”.
Przesyłaj klucz w każdym żądaniu jako Authorization: Bearer ept_…. Nie ujawniaj go nikomu: każdy, kto go ma, może wydawać Twoje kredyty.
Ceny
- Standardowy: 1 kredyt za 250 słów (co najmniej 1).
- Pro: 1 kredyt za 75 słów (co najmniej 2).
- Cena tłumaczenia między dwoma językami innymi niż angielski jest podwójna.
- 100 kredytów = 1 USD.
Kredyty za nieudane tłumaczenie są zwracane.
Punkty końcowe
Bazowy URL: https://translate.edgepedia.ai. Żądania i odpowiedzi mają format JSON; błąd ma postać {"error": "…"}.
GET /api/v1/languages
Lista języków z informacją o dostępności trybu Pro dla każdego z nich.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Twoje kredyty.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
Cena i przewidywany czas tłumaczenia bez jego uruchamiania. mode ma wartość standard lub pro.
Wycena przyjmuje też "source": "auto": odpowiedź podaje wykryty język w polu "source", wraz z "detected": true, a tłumaczenie uruchamia się następnie z tym kodem języka.
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
Uruchom tłumaczenie tekstu lub pliku .txt, .md, .docx albo .pdf o rozmiarze do 10 MB. Dodaj "expect_credits", aby żądanie zostało odrzucone (409), jeśli cena różni się od oczekiwanej. Dodaj "wait" (do 120 sekund), aby otrzymać gotowe tłumaczenie w tej samej odpowiedzi.
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}
Status tłumaczenia (queued, running, done lub failed) oraz jego tekst po zakończeniu. W przypadku niepowodzenia podawana jest przyczyna. Gotowe tłumaczenie można pobierać przez 30 dni.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Wynik tłumaczenia pliku: plik .docx dla plików .docx i .pdf, tekst dla plików .txt i .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Twoje tłumaczenia, od najnowszego, maksymalnie 50.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Kody statusu
| Kod | Znaczenie |
|---|---|
| 200 | OK; przy uruchomieniu z wait tłumaczenie jest zakończone lub nieudane. |
| 202 | Uruchomiono lub nadal trwa po upływie wait. |
| 400 | Nie można wykonać tłumaczenia na podstawie przesłanego żądania; komunikat błędu podaje przyczynę. |
| 401 | Brak klucza, klucz nieznany lub unieważniony. |
| 402 | Za mało kredytów. |
| 404 | Na Twoim koncie nie ma takiego tłumaczenia. |
| 409 | Cena różni się od wartości expect_credits; nie pobrano żadnej opłaty. |
| 413 | Plik ma więcej niż 10 MB. |
| 429 | Przekroczono 60 żądań na minutę; spróbuj ponownie po upływie liczby sekund podanej w Retry-After. |