REST API

Documentacao da API

Integre a traducao de manga no seu aplicativo com uma API REST simples.

Inicio Rapido

Obtenha uma chave de API

Crie uma chave nas configuracoes do seu painel. As chaves comecam com mg_live_ ou mg_test_.

Envie uma imagem

Solicite uma URL pre-assinada, depois faca PUT dos bytes da imagem nela.

Crie um trabalho

Envie a chave de upload para iniciar a traducao. Consulte o trabalho ate que ele seja concluido.

Autenticacao

Inclua sua chave de API como um token Bearer no cabecalho Authorization.

Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Chaves de modo ativo (mg_live_) usam seus creditos reais.
Chaves de modo de teste (mg_test_) usam GPU simulado -- nenhum credito consumido.

Referencia de Endpoints

URL base: https://api.mangagloss.com

POST/v1/uploads/presignObter URL de upload pre-assinado

Retorna uma URL pre-assinada para enviar uma imagem ao armazenamento R2.

Request

{
  "count": 1
}

Response

{
  "uploads": [
    { "key": "abc123...", "url": "https://..." }
  ]
}

PUT/v1/uploads/direct/:keyEnviar imagem

Envie 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 }

POST/v1/jobsCriar trabalho de traducao

Inicie 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..." }

GET/v1/jobs/:idObter status do trabalho

Consulte 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": [...]
    }
  ]
}

Exemplos de Codigo

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"

Limites de Taxa e Erros

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

Pronto para integrar?

Crie uma chave de API e comece a traduzir manga programaticamente.

Criar uma chave de API