# Voicfy

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

## AI Gateway
- OpenAPI: https://es.voicfy.com/api/ai/openapi
- Preferred endpoint (best ranked): https://es.voicfy.com/api/ai/voice-best
- Search voices: https://es.voicfy.com/api/ai/voice-search
- Voice filters: https://es.voicfy.com/api/ai/voice-filters
- Voice by id: https://es.voicfy.com/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
- https://es.voicfy.com/api/ai/voice-best?language=de&gender=male&voiceAge=middle_aged&topK=5