Loading...
Integre a traducao de manga no seu aplicativo com uma API REST simples.
Crie uma chave nas configuracoes do seu painel. As chaves comecam com mg_live_ ou mg_test_.
Solicite uma URL pre-assinada, depois faca PUT dos bytes da imagem nela.
Envie a chave de upload para iniciar a traducao. Consulte o trabalho ate que ele seja concluido.
Inclua sua chave de API como um token Bearer no cabecalho Authorization.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxURL base: https://api.mangagloss.com
/v1/uploads/presignObter URL de upload pre-assinadoRetorna uma URL pre-assinada para enviar uma imagem ao armazenamento R2.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keyEnviar imagemEnvie os bytes da imagem bruta para a URL pre-assinada. Envie o tipo de conteudo da imagem no cabecalho.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsCriar trabalho de traducaoInicie um trabalho de traducao para imagens enviadas. Requer creditos (1 por pagina).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idObter status do trabalhoConsulte este endpoint ate que o status seja completed ou failed. Os resultados incluem URLs de imagens traduzidas e regioes de texto.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}Fluxo completo de traducao de uma pagina no seu idioma de escolha.
# 1. Get a presigned upload URL
PRESIGN=$(curl -s -X POST https://api.mangagloss.com/v1/uploads/presign \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"count": 1}')
KEY=$(echo $PRESIGN | jq -r '.uploads[0].key')
URL=$(echo $PRESIGN | jq -r '.uploads[0].url')
# 2. Upload the image
curl -s -X PUT "$URL" \
-H "Content-Type: image/png" \
--data-binary @page.png
# 3. Create a translation job
JOB=$(curl -s -X POST https://api.mangagloss.com/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"pages\": [\"$KEY\"], \"source_lang\": \"JPN\", \"target_lang\": \"ENG\", \"engine\": \"premium\"}")
JOB_ID=$(echo $JOB | jq -r '.job_id')
# 4. Poll until complete
curl -s https://api.mangagloss.com/v1/jobs/$JOB_ID \
-H "Authorization: Bearer YOUR_API_KEY"As chaves de API tem limite de 30 solicitacoes por minuto. Os creditos sao a barreira real.
| Status | Significado |
|---|---|
200 | Sucesso |
400 | Solicitacao invalida -- verifique seus parametros |
401 | Nao autorizado -- chave de API ausente ou invalida |
402 | Creditos insuficientes |
404 | Recurso nao encontrado |
429 | Limite de taxa excedido -- aguarde e tente novamente |
500 | Erro do servidor -- tente novamente com backoff |
Crie uma chave de API e comece a traduzir manga programaticamente.
Criar uma chave de API