> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Suno Voice Create > Use DeerAPI to call the Suno Voice Create endpoint with request details, response details, examples, and an OpenAPI playground. ## Overview Use this endpoint to call the Suno Voice Create workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint. ## Before you start Use the DeerAPI base URL and pass your API Key in the `Authorization` header: ```text theme={null} https://api.deerapi.com ``` ```text theme={null} Authorization: Bearer $DEERAPI_KEY ``` ## Model selection Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first. ## Implementation notes * Use the OpenAPI playground for the exact request fields accepted by this endpoint. * Keep API Keys on the server side when you build production applications. * Log the request ID from failed calls so support can investigate the request. * Retry `429`, `500`, and `503` responses with exponential backoff. ## OpenAPI ````yaml /api/openapi/music/suno/post-voice-create.openapi.json POST /suno/persona/voice/create openapi: 3.1.0 info: title: Create Voice Persona API version: 1.0.0 servers: - url: https://api.deerapi.com security: - bearerAuth: [] paths: /suno/persona/voice/create: post: summary: Create voice persona operationId: voice_create_persona requestBody: required: true content: application/json: schema: type: object required: - name - persona_type - vox_audio_id - voice_recording_id - verification_id properties: name: type: string description: Persona name description: type: string description: Persona description image_s3_id: type: string description: Image in Base64 format (data:image/jpeg;base64,...) is_public: type: boolean description: >- Whether the persona is public (note: always reset to false regardless of input) persona_type: type: string description: Must be vox enum: - vox vocal_start_s: type: number description: Vocal start time (seconds) vocal_end_s: type: number description: Vocal end time (seconds) user_input_styles: type: string description: Style description source: type: string description: Source type singer_skill_level: type: string description: Singer skill level enum: - Advanced - Intermediate - Beginner - Professional is_voice_recording: type: boolean description: Whether this is a voice recording vox_audio_id: type: string description: vox_audio_id from the upload voice step voice_recording_id: type: string description: voice_recording_id from the upload voice step verification_id: type: string description: verification_id from the voice verification step examples: Example 1: summary: Example 1 value: name: mytitle description: my voice persona is_public: true persona_type: vox vocal_start_s: 0 vocal_end_s: 23.24 user_input_styles: pop source: random_song singer_skill_level: Intermediate is_voice_recording: true vox_audio_id: 9e196fa1-20f3-43c1-8066-06a2a6b6bea9 voice_recording_id: 575023b1-b071-4dbd-9f0d-176665c60768 verification_id: 979282b1-8968-46bc-b599-ea14946be48e example: name: mytitle description: my voice persona is_public: true persona_type: vox vocal_start_s: 0 vocal_end_s: 23.24 user_input_styles: pop source: random_song singer_skill_level: Intermediate is_voice_recording: true vox_audio_id: 9e196fa1-20f3-43c1-8066-06a2a6b6bea9 voice_recording_id: 575023b1-b071-4dbd-9f0d-176665c60768 verification_id: 979282b1-8968-46bc-b599-ea14946be48e responses: '200': description: Success content: application/json: schema: type: object properties: id: type: string description: Successfully created persona_id x-codeSamples: - lang: Shell label: cURL source: | curl https://api.deerapi.com/suno/persona/voice/create \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $DEERAPI_KEY" \ -d '{ "name": "mytitle", "description": "my voice persona", "is_public": true, "persona_type": "vox", "vocal_start_s": 0, "vocal_end_s": 23.24, "user_input_styles": "pop", "source": "random_song", "singer_skill_level": "Intermediate", "is_voice_recording": true, "vox_audio_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9", "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768", "verification_id": "979282b1-8968-46bc-b599-ea14946be48e" }' - lang: Python label: requests source: | import os import requests url = "https://api.deerapi.com/suno/persona/voice/create" headers = { "Authorization": "Bearer " + os.environ["DEERAPI_KEY"], "Content-Type": "application/json", } payload = { "name": "mytitle", "description": "my voice persona", "is_public": true, "persona_type": "vox", "vocal_start_s": 0, "vocal_end_s": 23.24, "user_input_styles": "pop", "source": "random_song", "singer_skill_level": "Intermediate", "is_voice_recording": true, "vox_audio_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9", "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768", "verification_id": "979282b1-8968-46bc-b599-ea14946be48e" } response = requests.post(url, headers=headers, json=payload) print(response.json()) - lang: JavaScript label: fetch source: > const response = await fetch("https://api.deerapi.com/suno/persona/voice/create", { method: "POST", headers: { Authorization: `Bearer ${process.env.DEERAPI_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "name": "mytitle", "description": "my voice persona", "is_public": true, "persona_type": "vox", "vocal_start_s": 0, "vocal_end_s": 23.24, "user_input_styles": "pop", "source": "random_song", "singer_skill_level": "Intermediate", "is_voice_recording": true, "vox_audio_id": "9e196fa1-20f3-43c1-8066-06a2a6b6bea9", "voice_recording_id": "575023b1-b071-4dbd-9f0d-176665c60768", "verification_id": "979282b1-8968-46bc-b599-ea14946be48e" }), }); console.log(await response.json()); components: securitySchemes: bearerAuth: type: http scheme: bearer description: Use a DeerAPI API Key as a Bearer token. ````