API de tradução
Envie seus próprios documentos ao Edgepedia Translate por meio de um script e receba as traduções. É o mesmo serviço da página de tradução, com os mesmos preços e usando os mesmos créditos.
Como obter uma chave
Crie uma chave na página de tradução: entre, abra sua conta no canto superior direito e escolha Criar em Chaves de API.
Envie a chave em todas as solicitações como Authorization: Bearer ept_…. Mantenha-a em segredo: qualquer pessoa com acesso a ela pode gastar seus créditos.
Preços
- Padrão: 1 crédito a cada 250 palavras (mínimo de 1 crédito).
- Pro: 1 crédito a cada 75 palavras (mínimo de 2 créditos).
- Nas traduções entre dois idiomas em que nenhum deles é o inglês, o preço é cobrado em dobro.
- 100 créditos = USD 1.
Se uma tradução falhar, os créditos usados serão devolvidos.
Rotas
URL base: https://translate.edgepedia.ai. As solicitações e respostas são em JSON; os erros têm o formato {"error": "…"}.
GET /api/v1/languages
Os idiomas, com a indicação de disponibilidade do modo Pro para cada um.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
Seus créditos.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
O preço e o tempo estimado de uma tradução, sem iniciá-la. mode pode ser standard ou pro.
A consulta de preço também aceita "source": "auto": a resposta informa o idioma detectado em "source", no campo "detected": true, e a tradução é então iniciada com esse código.
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
Inicie a tradução de um texto ou de um arquivo .txt, .md, .docx ou .pdf de até 10 MB. Adicione "expect_credits" para que a solicitação seja recusada (409) se o preço não for o esperado. Adicione "wait" (até 120 segundos) para receber a tradução concluída na mesma resposta.
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}
O status de uma tradução (queued, running, done ou failed) e, quando concluída, seu texto. Se houver falha, a resposta informa o motivo. Uma tradução concluída pode ser recuperada por 30 dias.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
O resultado da tradução de um arquivo: um .docx para arquivos .docx e .pdf, texto para .txt e .md.
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
Suas traduções, das mais recentes para as mais antigas, até o limite de 50.
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
Códigos de status
| Código | Significado |
|---|---|
| 200 | OK; para uma operação iniciada com wait, a tradução foi concluída ou falhou. |
| 202 | Iniciada ou ainda em andamento após wait. |
| 400 | Não é possível traduzir a solicitação como foi enviada; o erro informa o motivo. |
| 401 | Chave ausente, desconhecida ou revogada. |
| 402 | Créditos insuficientes. |
| 404 | Esta tradução não foi encontrada na sua conta. |
| 409 | O preço não corresponde ao valor de expect_credits que você enviou; nada foi cobrado. |
| 413 | O arquivo tem mais de 10 MB. |
| 429 | Mais de 60 solicitações em um minuto; tente novamente após os segundos indicados em Retry-After. |