---
title: "Suggest voices of a variant"
method: GET
path: "/v1/collections/{id}/variants/{variantId}/voice/suggestions"
tags: ["Voice"]
deprecated: true
---

# Suggest voices of a variant

`GET /v1/collections/{id}/variants/{variantId}/voice/suggestions`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/collections/{id}/variants/{variantId}/voice/suggestions`
- Auth: HTTP bearer

> **Deprecated.**

Returns voice ideas written for an approved variant from its references and description. Each description is ready for POST /v1/collections/{id}/variants/{variantId}/voice/samples. No credit cost.

## Path parameters

- `id` string, uuid, required
- `variantId` string, uuid, required

## Query parameters

- `refresh` 'true' | 'false': Return other ideas than a plain request would.
- `avoid` string: Comma-separated idea titles not to suggest again.

## Response `200`

Voice ideas

- object
  - `data` object, required
    - `ideas` VoiceIdea[], required
      - `title` string, required: A few words, such as "Cozy and warm".
      - `description` string, required: The full description, ready for POST .../voice/samples.

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: The key lacks permission, or the voice belongs to the Marketplace creator
- `404`: Mascot, variant or sample not found
- `409`: The variant is not approved yet, or the sample expired
- `429`: Too many voice requests; retry later
- `502`: Masko could not write the ideas or the adjustment; retry
- `503`: The voice service is unavailable; retry later

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/84832e255613?raw)