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://api.transpera.io

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_text / ocr_translate / image_translate45 credits per source page or image
document.extractextractionocr_extract_pdf / ocr_extract_image30 credits per page / image
document.transliteratedocument-translationtranslate_text / ocr_translate / image_translate45 credits per page or image
document.summarizedocument-translation (insights)summary_page30 credits per requested page
audio.transcribeaudioaudio_transcription1 credit per minute of audio
document.narrateaudioaudio80 credits per narrated page
audio.dubaudioaudio_dubbing80 credits per minute of audio
music.generateaudiomusic_generation80 credits per track