Loading...
Интегрируйте перевод манги в ваше приложение с помощью простого REST API.
Создайте ключ в настройках вашей панели управления. Ключи начинаются с mg_live_ или mg_test_.
Запросите предподписанный URL, затем отправьте байты изображения методом PUT.
Отправьте ключ загрузки, чтобы начать перевод. Опрашивайте задачу до её завершения.
Включите ваш API-ключ как Bearer токен в заголовке Authorization.
Authorization: Bearer mg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxБазовый URL: https://api.mangagloss.com
/v1/uploads/presignПолучить предподписанный URL для загрузкиВозвращает предподписанный URL для загрузки изображения в хранилище R2.
Request
{
"count": 1
}Response
{
"uploads": [
{ "key": "abc123...", "url": "https://..." }
]
}/v1/uploads/direct/:keyЗагрузить изображениеЗагрузите необработанные байты изображения на предподписанный URL. Отправьте тип содержимого изображения в заголовке.
Request
Raw image bytes (Content-Type: image/png or image/jpeg)Response
{ "ok": true }/v1/jobsСоздать задачу переводаНачните задачу перевода для загруженных изображений. Требуются кредиты (1 за страницу).
Request
{
"pages": ["abc123..."],
"source_lang": "JPN",
"target_lang": "ENG",
"engine": "premium"
}Response
{ "job_id": "x7k9m2..." }/v1/jobs/:idПолучить статус задачиОпрашивайте этот эндпоинт, пока статус не станет completed или failed. Результаты включают URL переведённых изображений и текстовые регионы.
Response
{
"id": "x7k9m2...",
"status": "completed",
"pages": [
{
"id": "p1...",
"status": "completed",
"output_url": "https://...",
"regions": [...]
}
]
}Полный процесс перевода одной страницы на вашем языке программирования.
# 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-ключи ограничены 30 запросами в минуту. Кредиты — это настоящий ограничитель.
| Статус | Значение |
|---|---|
200 | Успех |
400 | Некорректный запрос — проверьте ваши параметры |
401 | Неавторизован — отсутствует или неверный API-ключ |
402 | Недостаточно кредитов |
404 | Ресурс не найден |
429 | Превышен лимит запросов — подождите и повторите |
500 | Ошибка сервера — повторите с отсрочкой |