> For the complete documentation index, see [llms.txt](https://docs.noiz.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.noiz.ai/api-documentation/voice-design.md).

# Voice Design

## Design a voice

> Analyze input (text description and/or image) to design a voice,  returning similar voice samples or generating new ones via AI.

```json
{"openapi":"3.0.3","info":{"title":"Voice API","version":"1.0.0"},"servers":[{"url":"https://noiz.ai/v1","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization"}},"responses":{"UnauthorizedError":{"description":"API Key missing or invalid","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}},"paths":{"/voice-design":{"post":{"tags":["Voice Design"],"summary":"Design a voice","description":"Analyze input (text description and/or image) to design a voice,  returning similar voice samples or generating new ones via AI.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"picture":{"type":"string","format":"binary","description":"Optional image file to analyze for voice design"},"voice_description":{"type":"string","maxLength":1000,"description":"Description of the desired voice (20-1000 characters)"},"guidance_scale":{"type":"number","minimum":0,"maximum":100,"default":5,"description":"Guidance scale for voice generation (0-100)"},"loudness":{"type":"number","minimum":-1,"maximum":1,"default":0.5,"description":"Loudness level (-1 to 1)"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Status code (0 = success)"},"message":{"type":"string"},"data":{"type":"object","properties":{"previews":{"type":"array","description":"List of voice preview samples","items":{"type":"object","properties":{"voice_id":{"type":"string","description":"Voice ID for this preview"},"audio":{"type":"string","description":"Base64 encoded audio data"}}}},"text":{"type":"string","description":"Sample text used for the voice preview"},"from_cache":{"type":"boolean","description":"Whether the result was retrieved from cache"},"features":{"type":"object","description":"Voice features extracted from analysis","properties":{"gender":{"type":"string","description":"Detected/specified gender"},"age":{"type":"string","description":"Detected/specified age range"},"language":{"type":"string","description":"Language code"},"voice_prompt":{"type":"string","description":"Generated voice prompt"},"display_name":{"type":"string","description":"Suggested display name for the voice"}}}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}}}}}
```