---
title: "Suno Voice Get Custom Voice Records"
method: GET
path: "/api/v1/voice/record-info"
tags: ["docs/en/Market/Suno API/voice", "suno接口/voice"]
---

# Suno Voice Get Custom Voice Records

`GET /api/v1/voice/record-info`

Query the custom Suno Voice generation result.

Use this endpoint with the `taskId` returned by the voice generation endpoint. When the task succeeds, the response contains `voiceId`, which can be used as the custom voice identifier in supported generation APIs.

## Status Handling

Check the `status` field to determine the next action:

- `wait_processing`, `processing_validate`, or `wait_validating`: the task is still being processed
- `success`: the voice is ready, use `voiceId` for future generation requests
- `processing_validate_fail` or `fail`: the task failed, check `errorMessage` for details

## Voice Availability

After receiving a `voiceId`, you can use the voice availability endpoint to confirm whether the generated voice can be used:

<Card
  title="Check Voice Availability"
  icon="lucide-badge-check"
  href="/suno-api/suno-voice-check-voice"
>
  Check whether the custom voice generated by the task is available
</Card>

Related resources

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

## Query parameters

- `taskId` string

## Response `200`

- object
  - `code` integer, required — Response status code
  - `msg` string, required — Response message
  - `data` object, required
    - `taskId` string, required — Task ID
    - `voiceId` string, required — The voice ID generated by the [Suno Voice Generate Verification Phrase API](/suno-api/suno-voice-validate)
    - `status` 'wait_processing' | 'processing_validate' | 'processing_validate_fail' | 'wait_validating' | 'success' | 'fail', required — Task status
    - `errorCode` integer, required — Error code
    - `errorMessage` string, required — Detailed error message if the task failed

---

[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)