API di traduzione
Invia i tuoi documenti a Edgepedia Translate tramite uno script e ricevi le traduzioni. È lo stesso servizio della pagina Traduzioni, agli stessi prezzi e con addebito sugli stessi crediti.
Ottenere una chiave
Crea una chiave dalla pagina Traduzioni: accedi, apri il tuo account in alto a destra e seleziona Crea sotto Chiavi API.
Invia la chiave con ogni richiesta come Authorization: Bearer ept_…. Tienila segreta: chiunque la possieda può spendere i tuoi crediti.
Prezzi
- Standard: 1 credito ogni 250 parole (minimo 1).
- Pro: 1 credito ogni 75 parole (minimo 2).
- Per le traduzioni tra due lingue entrambe diverse dall'inglese, il prezzo raddoppia.
- 100 crediti = 1 USD.
Se una traduzione non riesce, i crediti vengono restituiti.
Endpoint
URL di base: https://translate.edgepedia.ai. Richieste e risposte sono in formato JSON; gli errori hanno la forma {"error": "…"}.
GET /api/v1/languages
Le lingue, con l'indicazione della disponibilità della modalità Pro per ciascuna.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
I tuoi crediti.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
Il prezzo e il tempo previsto per una traduzione, senza avviarla. mode può essere standard o pro.
Il preventivo accetta anche "source": "auto": la risposta indica in "detected": true la lingua rilevata in "source"; poi avvii la traduzione con quel codice.
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
Avvia la traduzione di un testo o di un file .txt, .md, .docx o .pdf fino a 10 MB. Aggiungi "expect_credits" per far rifiutare la richiesta (409) se il prezzo non corrisponde a quello previsto. Aggiungi "wait" (fino a 120 secondi) per ottenere la traduzione completata nella stessa risposta.
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}
Lo stato di una traduzione (queued, running, done o failed) e, una volta completata, il suo testo. Se la traduzione non è riuscita, ne viene indicato il motivo. Una traduzione completata può essere recuperata per 30 giorni.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
Il risultato della traduzione di un file: un .docx per i file .docx e .pdf, testo per i file .txt e .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Le tue traduzioni, dalla più recente, fino a un massimo di 50.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Codici di stato
| Codice | Significato |
|---|---|
| 200 | OK; per un avvio con wait, la traduzione è completata o non riuscita. |
| 202 | Avviata, o ancora in corso dopo wait. |
| 400 | La richiesta non può essere tradotta così come è stata inviata; l'errore ne indica il motivo. |
| 401 | Chiave mancante, sconosciuta o revocata. |
| 402 | Crediti insufficienti. |
| 404 | Nessuna traduzione corrispondente nel tuo account. |
| 409 | Il prezzo non corrisponde a expect_credits; non è stato addebitato nulla. |
| 413 | Il file supera i 10 MB. |
| 429 | Più di 60 richieste in un minuto; riprova dopo il numero di secondi indicato in Retry-After. |