Getting Started

Overview

Welcome to Transpera Studio API. One public API, one job resource, and unified AI operations for document translation, extraction, transliteration, and summarization.

Transpera Studio API exposes the full capabilities of Transpera's AI document engines to software developers. Rather than dealing with disparate workers and credentials, callers interact with a single versioned `/v1` service on Cloud Run.

Base URL

Code
https://transpera-api-dev-vv55i7vbvq-el.a.run.app

Architecture & Trust Boundary

The API is strictly separated from internal infrastructure to safeguard sensitive credentials and protect worker compute:

LayerResponsibilityCredential Handled
CallersExternal developers and backend serversBearer tp_live_ or tp_test_ key
API Serviceapps/transpera-api on Cloud RunHashes secret, loads scopes, credits assert/consume
AI WorkersDocument translation, OCR extraction, audio, videoGCP API Gateway key & service OIDC (server-only)
WebhooksInternal completion callbacksHMAC-SHA256 signature verification

Active Operations

Every studio tool is an operation on the unified job resource. Check GET /v1/operations at any time for the live catalog.

OperationWorker EngineBilling OperationCredits
document.translatedocument-translationtranslate_text45 credits per source page
document.extractextractionocr_extract_pdf / ocr_extract_image30 credits per page / image
document.transliteratedocument-translationtranslate_text45 credits per page
document.summarizedocument-translation (insights)summary_page30 credits per requested page