Speech API
Programmatic speech through REST, MCP, and supported integrations; authentication and API-key ownership.
Creative and API ownership
Giggy Creative uses the Personal space or Workspace currently selected in the browser. REST and MCP requests use the Personal space or Workspace that permanently owns the API key. They use the same Giggy speech system and generation infrastructure.
REST and MCP authentication
REST and MCP both use a Giggy Speech API key beginning with giggy_sk_. REST accepts xi-api-key; MCP accepts the same key as an Authorization bearer credential.
API key lifecycle
A REST API key permanently belongs to the Personal space or Workspace in which it was created. A Workspace key bills that Workspace, creates Workspace-owned API resources, and may use completed custom voices owned by that same Workspace. It cannot access a member’s Personal custom voices. Members may manage Workspace keys they created; Admins may manage every Workspace key. MCP uses the same Giggy API-key ownership model as REST. A Personal key uses Personal credits and resources; a Workspace key uses that Workspace’s credits and resources. Keys are permanently bound to the space where they were created. Switching spaces does not transfer a key. New or rotated plaintext keys are shown once; save them securely and keep them server-side.
Custom voices through the API
Custom voice access follows ownership. A Personal API key can list and use completed custom voices owned by Personal. A Workspace API key can list and use completed custom voices owned by that same Workspace, but not a member’s Personal voices. The same ownership rules apply to REST and MCP. Voice Design and Voice Clone themselves remain authenticated product workflows rather than public REST v1 or MCP creation methods.
API reference and integrations
Use the developer documentation for REST request and response contracts, MCP tools and setup, OpenAI-compatible speech, Vapi, error handling, and generation lifecycle. Generation modes is the shared reference for character limits, priority, and MP3 or PCM delivery.