edgepedia tłumaczenia

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

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

KodZnaczenie
200OK; przy uruchomieniu z wait tłumaczenie jest zakończone lub nieudane.
202Uruchomiono lub nadal trwa po upływie wait.
400Nie można wykonać tłumaczenia na podstawie przesłanego żądania; komunikat błędu podaje przyczynę.
401Brak klucza, klucz nieznany lub unieważniony.
402Za mało kredytów.
404Na Twoim koncie nie ma takiego tłumaczenia.
409Cena różni się od wartości expect_credits; nie pobrano żadnej opłaty.
413Plik ma więcej niż 10 MB.
429Przekroczono 60 żądań na minutę; spróbuj ponownie po upływie liczby sekund podanej w Retry-After.