# Voicfy

> Voicfy is a voice-over marketplace with searchable voice actor data and TTS capabilities.

## AI Gateway
- [OpenAPI](https://voicfy.de/api/ai/openapi)
- [Preferred endpoint (best ranked)](https://voicfy.de/api/ai/voice-best)
- [Search voices](https://voicfy.de/api/ai/voice-search)
- [Voice filters](https://voicfy.de/api/ai/voice-filters)
- [Voice by id](https://voicfy.de/api/ai/voice/{id})

## Agent Instructions
1. First call /api/ai/voice-filters to learn supported values.
2. Use /api/ai/voice-best for final recommendations shown to users.
3. If needed, call /api/ai/voice-search for broader exploration and pagination.
4. Use /api/ai/voice/{id} for detail cards before final answer.

## Query Parameters
- Common: q, language, origin, voiceAge, gender, category
- Ranking: topK (for /voice-best, default 5, max 20)
- Raw search only: page, limit, sortBy, sortOrder, status

## Example
- [Best-voice example](https://voicfy.de/api/ai/voice-best?language=de&gender=male&voiceAge=middle_aged&topK=5)