Loading...
Integra la traduccion de manga en tu aplicacion con una API REST simple.
Crea una clave desde la configuracion de tu panel. Las claves comienzan con mg_live_ o mg_test_.
Solicita una URL prefirmada, luego envia los bytes de la imagen con PUT.
Envia la clave de subida para iniciar la traduccion. Consulta el trabajo hasta que se complete.
Incluye tu clave de API como un token Bearer en el encabezado Authorization.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxURL base: https://api.mangagloss.com
/v1/uploads/presignObtener URL de subida prefirmadaDevuelve una URL prefirmada para subir una imagen al almacenamiento R2.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keySubir imagenSube los bytes de la imagen sin procesar a la URL prefirmada. Envia el tipo de contenido de la imagen en el encabezado.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsCrear trabajo de traduccionInicia un trabajo de traduccion para las imagenes subidas. Requiere creditos (1 por pagina).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idObtener estado del trabajoConsulta este endpoint hasta que el estado sea completed o failed. Los resultados incluyen URLs de imagenes traducidas y regiones de texto.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}Flujo completo de traduccion de una pagina en el lenguaje de tu eleccion.
# 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"Las claves de API tienen un limite de 30 solicitudes por minuto. Los creditos son el verdadero control.
| Estado | Significado |
|---|---|
200 | Exito |
400 | Solicitud incorrecta -- verifica tus parametros |
401 | No autorizado -- clave de API faltante o invalida |
402 | Creditos insuficientes |
404 | Recurso no encontrado |
429 | Limite de tasa alcanzado -- espera y vuelve a intentar |
500 | Error del servidor -- reintenta con retroceso |
Crea una clave de API y comienza a traducir manga programaticamente.
Crear una clave de API