Skip to main content
Everything shared by the Text-to-Speech endpoints: the base URL, how to authenticate, request IDs and account limits.

API Resources

Base URL: https://api.plivo.com/v1/Account/{auth_id}/TTS/ No route takes query parameters. Sending one returns 422 invalid_request with param naming it.

Authentication

Use HTTP Basic auth with your Auth ID and Auth Token. This applies to the WebSocket upgrade too: a bad credential is refused with an HTTP status, so the socket never opens.
A subaccount uses its own Auth ID and Auth Token. The main account is billed. A 401 reply carries WWW-Authenticate: Basic realm="plivo".

Request IDs

Every reply has a connection-id header. It’s the same value as api_id in REST bodies and connection_id in WebSocket events: 16 hex digits, for example 148d6af0bee98c09. Give it to Plivo Support when you report a problem. To tag requests with your own reference, send the optional client-ref header: 1 to 64 characters of A-Z, a-z, 0-9, _ or -. The ID then becomes <client-ref>.<16 hex digits>, for example order-4581.148d6af0bee98c09.

Limits

Billing

Per character. Each done event and the Usage API report billed characters.