Loading...
Integriere Manga-Übersetzung in deine App mit einer einfachen REST API.
Erstelle einen Schlüssel in deinen Dashboard-Einstellungen. Schlüssel beginnen mit mg_live_ oder mg_test_.
Fordere eine vorsignierte URL an und lade dann die Bilddaten per PUT darauf hoch.
Sende den Upload-Schlüssel, um die Übersetzung zu starten. Frage den Auftragsstatus ab, bis er abgeschlossen ist.
Füge deinen API-Schlüssel als Bearer-Token im Authorization-Header hinzu.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxBasis-URL: https://api.mangagloss.com
/v1/uploads/presignVorsignierte Upload-URL abrufenGibt eine vorsignierte URL zum Hochladen eines Bildes in den R2-Speicher zurück.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keyBild hochladenLade rohe Bilddaten zur vorsignierten URL hoch. Sende den Bild-Content-Type im Header.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsÜbersetzungsauftrag erstellenStarte einen Übersetzungsauftrag für hochgeladene Bilder. Erfordert Credits (1 pro Seite).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idAuftragsstatus abrufenFrage diesen Endpunkt ab, bis der Status completed oder failed ist. Ergebnisse enthalten übersetzte Bild-URLs und Textregionen.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}Vollständiger Workflow zum Übersetzen einer einzelnen Seite in deiner bevorzugten Programmiersprache.
# 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"API-Schlüssel sind auf 30 Anfragen pro Minute begrenzt. Credits sind die eigentliche Beschränkung.
| Status | Bedeutung |
|---|---|
200 | Erfolgreich |
400 | Ungültige Anfrage – überprüfe deine Parameter |
401 | Nicht autorisiert – fehlender oder ungültiger API-Schlüssel |
402 | Unzureichende Credits |
404 | Ressource nicht gefunden |
429 | Ratenbegrenzung – warten und erneut versuchen |
500 | Serverfehler – mit Backoff erneut versuchen |
Erstelle einen API-Schlüssel und beginne, Manga programmatisch zu übersetzen.
API-Schlüssel erstellen