Loading...
Intégrez la traduction de manga dans votre application avec une simple API REST.
Créez une clé depuis les paramètres de votre tableau de bord. Les clés commencent par mg_live_ ou mg_test_.
Demandez une URL présignée, puis envoyez les octets de l'image avec PUT.
Soumettez la clé de téléversement pour démarrer la traduction. Interrogez la tâche jusqu'à ce qu'elle soit terminée.
Incluez votre clé API comme jeton Bearer dans l'en-tête Authorization.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxURL de base: https://api.mangagloss.com
/v1/uploads/presignObtenir une URL de téléversement présignéeRenvoie une URL présignée pour téléverser une image vers le stockage R2.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keyTéléverser une imageTéléversez les octets bruts de l'image vers l'URL présignée. Envoyez le type de contenu de l'image dans l'en-tête.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsCréer une tâche de traductionDémarrez une tâche de traduction pour les images téléversées. Nécessite des crédits (1 par page).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idObtenir le statut de la tâcheInterrogez cet endpoint jusqu'à ce que le statut soit terminé ou échoué. Les résultats incluent les URL des images traduites et les régions de texte.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}Flux complet de traduction d'une page dans le langage de votre choix.
# 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"Les clés API sont limitées à 30 requêtes par minute. Les crédits sont la véritable garde-fou.
| Statut | Signification |
|---|---|
200 | Succès |
400 | Requête invalide — vérifiez vos paramètres |
401 | Non autorisé — clé API manquante ou invalide |
402 | Crédits insuffisants |
404 | Ressource introuvable |
429 | Limite de taux atteinte — attendez et réessayez |
500 | Erreur serveur — réessayez avec un délai exponentiel |
Créez une clé API et commencez à traduire des manga par programmation.
Créer une clé API