API Reference · v1

LUTUNG AI API

Integrate LUTUNG AI services into your application over a simple HTTPS + JSON API.

Access in this MVP

Public self-service API keys are not available yet. Endpoints are used by the LUTUNG Playground and require a signed-in LUTUNG session. Pilot developers who need integration access should contact the LUTUNG team.

Base URL & versioning

Base URL

https://<lutung-host>/api/v1

All endpoints are versioned under /api/v1. Breaking changes ship under a new version prefix.

Services

Document Detection/api/v1/playground/document-detection GratisBeta OCR KTP/api/v1/playground/ocr-ktp 1x uji coba gratisBeta

Public endpoints

No authentication required.

Endpoint	Description
GET `/api/v1/technologies`	List all catalog entries
GET `/api/v1/technologies/{slug}`	Get one technology
GET `/api/v1/health`	Portal and per-service status

Error codes

Errors use a consistent shape. Every response carries an X-Request-Id header — include it when reporting issues.

Error response

{"request_id": "req_…", "error": {"code": "RATE_LIMITED", "message": "Too many requests. Please try again later."}}

Code	HTTP	Meaning / what to do
`INVALID_FILE`	400 · 411 · 415	Unsupported, malformed or empty upload. Select a supported file and retry.
`FILE_TOO_LARGE`	413	Upload exceeds the size or dimension limit. Reduce file size.
`UNAUTHORIZED`	401	Missing, expired or invalid identity token. Sign in again.
`CONSENT_REQUIRED`	403	Data-handling notice must be acknowledged before using a sensitive-document service.
`TRIAL_ALREADY_USED`	403	Free trial consumed. Paid access is not available yet; contact the team for pilot access.
`TRIAL_IN_PROGRESS`	409	Another trial request for this account is processing. Wait for it to finish.
`RATE_LIMITED`	429	Request limit exceeded. Wait for the `Retry-After` interval.
`SERVICE_UNAVAILABLE`	503	Provider unavailable, busy, or under maintenance. Retry later; do not submit repeatedly.
`PROCESSING_TIMEOUT`	504	Processing exceeded the configured timeout. A trial is not consumed.
`INTERNAL_ERROR`	500	Unexpected server failure. Report the request ID.