edgepedia traduci

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

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

CodiceSignificato
200OK; per un avvio con wait, la traduzione è completata o non riuscita.
202Avviata, o ancora in corso dopo wait.
400La richiesta non può essere tradotta così come è stata inviata; l'errore ne indica il motivo.
401Chiave mancante, sconosciuta o revocata.
402Crediti insufficienti.
404Nessuna traduzione corrispondente nel tuo account.
409Il prezzo non corrisponde a expect_credits; non è stato addebitato nulla.
413Il file supera i 10 MB.
429Più di 60 richieste in un minuto; riprova dopo il numero di secondi indicato in Retry-After.