Get Similar Voices

Return voices acoustically similar to a reference voice.

Results are ranked by semantic similarity score (descending) and include the reference voice’s workspace voices and all platform voices. Each result includes a similarity_score between 0 and 1. Optionally filter by one or more language BCP-47 codes (repeat the parameter for OR semantics); up to 16 language values are accepted. Results are restricted to officially supported locales on the same terms as GET /voices; the reference voice itself is not, so you can ask for neighbours of a voice that no longer appears in the list. Returns 503 when the reference voice has no embedding yet — retry after the indicated Retry-After interval. Prefer this endpoint over GET /voices with manual filtering when building a “voices like this” recommendation UI.

Platform voices from providers that are not available to your account are rejected as a reference (404) and omitted from the results; voices your workspace owns are unaffected. This endpoint sets Cache-Control: no-store because the response bakes in short-lived presigned sample URLs — server-side (Redis) caching still applies underneath for the default limit/language shape.