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.
5-Minute Quickstart
Go from zero to a translated document in under 5 minutes with our step-by-step guide.
Read guide âCore ToolsDoc Studio Tools
Explore Translation, Extraction with OCR, Transliteration, Summarization, and InDesign.
Read guide âRecipesEnd-to-End Tutorials
Recipes for automated multilingual pipelines, receipt OCR, and executive report generators.
Read guide âv1 ContractAPI Reference
Full HTTP endpoint specifications with request schemas, parameter tables, and headers.
Read guide âBase URL
https://transpera-api-dev-vv55i7vbvq-el.a.run.appArchitecture & Trust Boundary
The API is strictly separated from internal infrastructure to safeguard sensitive credentials and protect worker compute:
| Layer | Responsibility | Credential Handled |
|---|---|---|
| Callers | External developers and backend servers | Bearer tp_live_ or tp_test_ key |
| API Service | apps/transpera-api on Cloud Run | Hashes secret, loads scopes, credits assert/consume |
| AI Workers | Document translation, OCR extraction, audio, video | GCP API Gateway key & service OIDC (server-only) |
| Webhooks | Internal completion callbacks | HMAC-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.
| Operation | Worker Engine | Billing Operation | Credits |
|---|---|---|---|
| document.translate | document-translation | translate_text | 45 credits per source page |
| document.extract | extraction | ocr_extract_pdf / ocr_extract_image | 30 credits per page / image |
| document.transliterate | document-translation | translate_text | 45 credits per page |
| document.summarize | document-translation (insights) | summary_page | 30 credits per requested page |