Image OCR API

Dokumentasi resmi Image OCR API dari Maelyn API untuk mengekstrak teks dari gambar secara otomatis menggunakan AI

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /ai/image/ocr
  • Method: POST
  • Credit Usage: 3

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk membaca teks (OCR) dari gambar menggunakan AI.

{
  "image_url": "https://example.com/image.jpg"
}

Body Parameters

NameTypeRequiredDescription
image_urlstringYes*URL gambar yang ingin diambil teksnya
urlstringYes*Alternatif dari image_url
imagestringYes*Alternatif dari image_url
languagestringNoBahasa OCR (default: eng)
enginenumberNoEngine OCR (default: 2)
is_tablebooleanNoAktifkan deteksi tabel
detect_orientationbooleanNoDeteksi rotasi/orientasi teks (default: true)

Salah satu dari image_url, url, atau image wajib diisi.

Example Usage

{
  "image_url": "https://example.com/image.png"
}

Example Usage (Advanced)

{
  "image_url": "https://example.com/image.png",
  "language": "eng",
  "engine": 2,
  "is_table": false,
  "detect_orientation": true
}

Success Response

{
  "success": true,
  "result": {
    "image": {
      "url": "https://example.com/image.png",
      "mime": "image/png",
      "size": "120.50 KB",
      "filename": "image.png"
    },
    "text": "Hello world\nIni hasil OCR dari gambar",
    "parsed_count": 1,
    "provider": "mlyn-ocr"
  }
}

Error Response

Invalid JSON

{
  "success": false,
  "error": "INVALID_JSON",
  "message": "Body request harus berupa JSON"
}

Image URL Required

{
  "success": false,
  "error": "IMAGE_URL_REQUIRED",
  "message": "Field image_url wajib diisi"
}

Invalid Image URL

{
  "success": false,
  "error": "INVALID_IMAGE_URL",
  "message": "Field image_url harus berupa URL gambar yang valid"
}

Image Download Failed

{
  "success": false,
  "error": "IMAGE_DOWNLOAD_FAILED",
  "message": "Gagal mendownload gambar dari URL yang diberikan"
}

Invalid Image Type

{
  "success": false,
  "error": "INVALID_IMAGE_TYPE",
  "message": "URL yang diberikan bukan file gambar yang valid"
}

OCR Request Failed

{
  "success": false,
  "error": "OCR_REQUEST_FAILED",
  "message": "Gagal menghubungi server OCR"
}

OCR Processing Failed

{
  "success": false,
  "error": "OCR_PROCESSING_FAILED",
  "message": "Terjadi kesalahan saat memproses OCR"
}

OCR Invalid Response

{
  "success": false,
  "error": "OCR_INVALID_RESPONSE",
  "message": "Response OCR tidak valid"
}

OCR Request Timeout

{
  "success": false,
  "error": "OCR_REQUEST_TIMEOUT",
  "message": "Server OCR terlalu lama merespon"
}

API Key Missing

{
  "success": false,
  "error": "OCR_API_KEY_MISSING",
  "message": "OCR API key tidak ditemukan pada server"
}

Internal Server Error

{
  "success": false,
  "error": "INTERNAL_SERVER_ERROR",
  "message": "Terjadi kesalahan pada sistem"
}

Playground