Interfaces

4. Interfaces

4.1 Client Application ↔ Cloud Service

Protocol: HTTPS
Authentication: Device token
Interaction Pattern: Request/response with streamed output

The Client Application sends authenticated synthesis requests to the Cloud Service. Each request includes a device token representing the linked runtime instance.

The Cloud Service validates the token, applies policy checks, and creates a synthesis job. Audio output is returned incrementally as a streamed response.

All synthesis requests are mediated by the Cloud Service.

4.2 Web Portal ↔ Cloud Service

Protocol: HTTPS
Authentication: User identity token (issued by the External Identity Provider)
Interaction Pattern: Request/response

The Web Portal sends authenticated account-related requests to the Cloud Service. These include operations such as retrieving usage information, managing devices, and initiating plan changes.

The Cloud Service validates user identity tokens before processing these requests.

4.3 Cloud Service ↔ Cloud Execution Workers

Protocol: Internal service communication
Authentication: Internal trust boundary
Interaction Pattern: Job dispatch and result streaming

After validating a synthesis request, the Cloud Service dispatches a job to the Cloud Execution Workers.

Workers perform speech synthesis and produce audio output, which is relayed to the Client Application by the Cloud Service.

4.4 Cloud Execution Workers ↔ External Speech Providers

Protocol: Provider-specific integration
Authentication: Provider credentials
Interaction Pattern: Synthesis request and audio response

Cloud Execution Workers invoke External Speech Providers to generate speech audio from text input. Provider responses are processed before being streamed back through the Cloud Service.