Parcourir chaque point de terminaison et lancer de vraies requêtes dans le navigateur
Scalar charge le schéma OpenAPI en direct (miroir sur /api/openapi). Authentifiez-vous comme le tableau de bord (Bearer jeton Firebase) ou avec X-API-Key depuis Compte → clés API. Les routes HTML /admin sont pour l’exploitation — protégez-les au bord du réseau ou par VPN.
Custom voices API: your library, your rules
Store validated reference clips, optional portraits, and preview audio once—then reference them from TTS by UUID without re-uploading sensitive files.
Reference audio becomes a reusable voice
Designing for product teams
Most APIs stop at anonymous uploads. VoiceChangerAPI gives you named voices, list filtering, PATCH updates, and delete semantics so you can mirror your own tenant model.
Reference audio must pass the same validation as the dashboard: real audio, tight duration windows, and size caps driven by environment variables—not magic constants in your code.
List responses include presigned image_url and preview_audio_url so your admin UI can render thumbnails and audition buttons without extra signing logic.
Lifecycle at a glance
These routes power the Custom voices grid inside the dashboard.
- 1
List or search
GET /v1/custom-voices supports optional query q for case-insensitive name matches. Inspect preview_script_text for the phrase used when generating previews.
- 2
Create with multipart data
POST /v1/custom-voices requires name and ref_audio. Optional image plus generate_preview (defaults on when configured) kicks off the preview job you see in the UI.
- 3
Update incrementally
PATCH /v1/custom-voices/{voice_id} accepts any combination of name, ref_audio, and image. Empty requests are rejected—send at least one field.
- 4
Delete and consume in TTS
DELETE removes database rows and best-effort S3 objects. Reference the voice_id from POST /v1/voice-cloning/tts as custom_voice_id for generation.
Create + use in TTS
After creation, copy the UUID from the response JSON.
curl -X POST "$API/v1/custom-voices" \ -H "Authorization: Bearer $JWT" \ -F name="Brand Host" \ -F ref_audio=@host.wav # Then: # -F custom_voice_id="$UUID" on /v1/voice-cloning/tts
Premium positioning? Pair custom voices with branded dashboard links for your customers.