> ## Documentation Index
> Fetch the complete documentation index at: https://docs.api.box/llms.txt
> Use this file to discover all available pages before exploring further.
# Suno Voice Get Custom Voice Record
> Query the custom Suno Voice generation result and obtain the generated voiceId.
### Usage Guide
* Use the `taskId` returned by the custom voice generation API.
* When `status` is `success`, the response contains the generated `voiceId`.
* If the task fails, use `errorCode` and `errorMessage` to decide whether to retry validation or generation.
### Status Handling
| Status | Meaning |
| -------------------------- | ---------------------------------------- |
| `wait_processing` | Task is waiting to be processed |
| `processing_validate` | Verification is being processed |
| `processing_validate_fail` | Verification failed |
| `wait_validating` | Waiting for validation to complete |
| `success` | Voice is ready and `voiceId` can be used |
| `fail` | Task failed |
### Related Endpoint
Confirm whether the generated custom voice is available for supported Suno generation APIs
## OpenAPI
````yaml /suno-api/suno-voice-api.json GET /api/v1/voice/record-info
openapi: 3.0.1
info:
title: Suno Voice API
description: API documentation for Suno Voice custom voice services
version: 1.0.0
contact:
name: Technical Support
email: support@api.box
servers: []
security:
- BearerAuth: []
tags:
- name: docs
- name: docs/en
- name: docs/en/Market
- name: docs/en/Market/Suno API
- name: docs/en/Market/Suno API/voice
- name: suno接口/voice
paths:
/api/v1/voice/record-info:
get:
tags:
- docs/en/Market/Suno API/voice
- suno接口/voice
summary: Suno Voice Get Custom Voice Records
description: >
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:
Check whether the custom voice generated by the task is available
Related resources
Submit verification audio and create a custom voice
View account credits and usage
operationId: suno-voice-record-info
parameters:
- name: taskId
in: query
description: 任务id
required: false
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: Response status code
msg:
type: string
description: Response message
data:
type: object
properties:
taskId:
description: Task ID
type: string
voiceId:
type: string
description: >-
The voice ID generated by the [Suno Voice Generate
Verification Phrase
API](/suno-api/suno-voice-validate)
status:
type: string
description: Task status
enum:
- wait_processing
- processing_validate
- processing_validate_fail
- wait_validating
- success
- fail
errorCode:
type: integer
description: Error code
errorMessage:
type: string
description: Detailed error message if the task failed
required:
- taskId
- voiceId
- status
- errorCode
- errorMessage
required:
- code
- msg
- data
example:
code: 200
msg: success
data:
taskId: xxx_task_id_xxx
voiceId: xxx
status: >-
wait_processing, processing_validate: waiting for validation
code, processing_validate_fail: failed to obtain validation
code, wait_validating: waiting for verification, success,
fail
errorCode: 500
errorMessage: xxxxx
headers: {}
deprecated: false
security:
- BearerAuth1: []
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: API Key
description: >-
# API Authentication
All endpoints require authentication using Bearer Token.
## Get API Key
1. Visit the [API Key Management Page](https://api.box/api-key) to
obtain your API Key
## Usage
Add to request headers:
```
Authorization: Bearer YOUR_API_KEY
```
> **Note:**
> - Keep your API Key secure and do not share it with others
> - If you suspect your API Key has been compromised, reset it
immediately from the management page
BearerAuth1:
type: http
scheme: bearer
bearerFormat: API Key
description: >-
# API Authentication
All endpoints require authentication using Bearer Token.
## Get API Key
1. Visit the [API Key Management Page](https://api.box/api-key) to
obtain your API Key
## Usage
Add to request headers:
```
Authorization: Bearer YOUR_API_KEY
```
> **Note:**
> - Keep your API Key secure and do not share it with others
> - If you suspect your API Key has been compromised, reset it
immediately from the management page
````