---
title: "Suno Voice Check Availability API"
method: POST
path: "/api/v1/voice/check-voice"
tags: ["docs/en/Market/Suno API/voice", "suno接口/voice"]
---

# Suno Voice Check Availability API

`POST /api/v1/voice/check-voice`

Check whether a generated Suno custom voice is available.

Use this endpoint after voice generation completes to verify that the generated voice can be used in supported Suno generation APIs. Submit the related task ID and check the `isAvailable` value in the response.

## When to Use

This endpoint is useful when you need to confirm voice availability before starting a music generation request that depends on the custom voice.

<Card
  title="Get Voice Record"
  icon="lucide-search"
  href="/suno-api/suno-voice-record-info"
>
  Query the voice generation task first to obtain the latest task status and generated voice information
</Card>

Related resources

<CardGroup cols={2}>
  <Card title="Generate Voice" icon="lucide-mic" href="/suno-api/suno-voice-generate"> Create a custom voice from verification audio </Card>
  <Card title="General API" icon="lucide-cog" href="/suno-api/get-remaining-credits"> View account credits and usage </Card>
</CardGroup>

## Request body

- object
  - `task_id` string, required — Task ID that needs to be checked

## Response `200`

- object
  - `code` integer, required
  - `msg` string, required
  - `data` object, required
    - `isAvailable` boolean, required

---

[API](https://skmtc.dev/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.dev/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/revisions/22d45ee33a4a/schema)