# Configuration

Retrieve available options for AI voices, avatars, background music, and video category tags. Call these endpoints to populate field values when creating a project.

## Get storytelling techniques

 - [GET /auth/config/storytelling_techniques](https://api-docs.shuffll.com/apis/configuration/getstorytellingtechniques.md): Retrieve all available storytelling techniques for video creation.
Returns an array of 12 storytelling techniques with descriptions, explanations of why they work, and examples.

Use these techniques when creating projects to structure your video narrative effectively.

## Get tone of voice options

 - [GET /auth/config/tone_of_voice](https://api-docs.shuffll.com/apis/configuration/gettoneofvoice.md): Retrieve all available tone of voice options for video narration.
Returns an array of tone options with descriptions.

Use the id value as toneOfVoice when creating a project.

## Get video category tags

 - [GET /auth/config/video_tags](https://api-docs.shuffll.com/apis/configuration/getvideotags.md): Retrieve all available video category tags.

Use the id value as videoTagId when creating a project to categorize your video (e.g., Marketing, Explainer, Training).

## Get AI voice options

 - [GET /auth/config/ai_voice_options](https://api-docs.shuffll.com/apis/configuration/getaivoiceoptions.md): Retrieve all available AI voice-over options and tone styles.

Returns two arrays:
- aiVoiceOptions — the list of available voices. Use the id value as aiVoiceSettings.voiceId when creating a project.
- aiVoiceTones — tone styles that can be layered on top of a voice (e.g., friendly, professional, dramatic).

Voices are provided by either OpenAI or ElevenLabs depending on the voiceType field.

## Get AI avatar options

 - [GET /auth/config/ai_avatar_options](https://api-docs.shuffll.com/apis/configuration/getaiavataroptions.md): Retrieve all available AI avatar presenter options.

Each avatar has a name, accent, and a preview video URL. Use the id value when configuring an AI avatar presenter for your project.

## Get background music library

 - [GET /auth/config/music-library](https://api-docs.shuffll.com/apis/configuration/getmusiclibrary.md): Retrieve all available background music tracks.

Use the relativePath value as customTemplate.preConfigs.bgMusic.path when creating a project to set the background music.