Services and permissions
An API key acts for the account that created it: it can call the services that account may use, and reach only that account’s own resources.
Services you can call
Section titled “Services you can call”| Capability | Costs credits? |
|---|---|
| Uploads and the file library | Uploading and querying are free |
| File translation and downloads | Translation is charged; status checks and downloads are free |
| PDF and image tools | Free |
| Document operations | extract and pdf_to_html are free; visual_extract is charged per page actually processed |
| Instant and batch segment translation | Billed by actual usage |
| Audio, video and voices | Billed by actual usage |
| Glossaries, projects, tags, search and sharing | Free |
| Usage, balance and settlement records | Free |
| SSE and webhooks (file translation jobs) | Free |
The account’s service status, file formats, per-request limits and concurrency limits apply as well. When a service is unavailable, the API returns a clear error; it never switches to another service on its own.
API keys are for calling the endpoints in these docs. A key cannot change the sign-in email, password, phone number or profile, and cannot create, rotate or revoke API keys; actions that need confirmation in a signed-in browser cannot be done with a key either. Guard your key like your account password.
Resources and auditing
Section titled “Resources and auditing”- Resources created with a key belong to the key’s account.
- The balance belongs to the account; each key can have its own budget and allowed translation settings.
- Queried with a key, credit operations, document operations and the voice list return only records that key started; the job list and usage return the account’s totals.
Queries are free
Section titled “Queries are free”GET /api/v1/jobs/{job_id}GET /api/v1/artifacts?job_id={job_id}GET /api/v1/billing/credits/balanceGET /api/v1/billing/credits/operationsGET /api/v1/usage/summaryWhen a key’s budget is used up, you can still query the jobs, results and credit records that key created.