List voices

1 from elevenlabs import ElevenLabs 2 3 client = ElevenLabs( 4 api_key="YOUR_API_KEY", 5 ) 6 client.voices.search( 7 include_total_count=True, 8 )

1 { 2 "voices": [ 3 { 4 "voice_id": "foo", 5 "name": "foo", 6 "samples": [ 7 { 8 "sample_id": "foo", 9 "file_name": "foo", 10 "mime_type": "foo", 11 "size_bytes": 42, 12 "hash": "foo", 13 "duration_secs": 42, 14 "remove_background_noise": true, 15 "has_isolated_audio": true, 16 "has_isolated_audio_preview": true, 17 "speaker_separation": { 18 "voice_id": "foo", 19 "sample_id": "foo", 20 "status": "not_started", 21 "speakers": {}, 22 "selected_speaker_ids": [ 23 "foo" 24 ] 25 }, 26 "trim_start": 42, 27 "trim_end": 42 28 } 29 ], 30 "category": "generated", 31 "fine_tuning": { 32 "is_allowed_to_fine_tune": true, 33 "state": {}, 34 "verification_failures": [ 35 "foo" 36 ], 37 "verification_attempts_count": 42, 38 "manual_verification_requested": true, 39 "language": "foo", 40 "progress": {}, 41 "message": {}, 42 "dataset_duration_seconds": 42, 43 "verification_attempts": [ 44 { 45 "text": "foo", 46 "date_unix": 42, 47 "accepted": true, 48 "similarity": 42, 49 "levenshtein_distance": 42, 50 "recording": { 51 "recording_id": "foo", 52 "mime_type": "foo", 53 "size_bytes": 42, 54 "upload_date_unix": 42, 55 "transcription": "foo" 56 } 57 } 58 ], 59 "slice_ids": [ 60 "foo" 61 ], 62 "manual_verification": { 63 "extra_text": "foo", 64 "request_time_unix": 42, 65 "files": [ 66 { 67 "file_id": "foo", 68 "file_name": "foo", 69 "mime_type": "foo", 70 "size_bytes": 42, 71 "upload_date_unix": 42 72 } 73 ] 74 }, 75 "max_verification_attempts": 42, 76 "next_max_verification_attempts_reset_unix_ms": 42, 77 "finetuning_state": null 78 }, 79 "labels": {}, 80 "description": "foo", 81 "preview_url": "foo", 82 "available_for_tiers": [ 83 "foo" 84 ], 85 "settings": { 86 "stability": 42, 87 "use_speaker_boost": true, 88 "similarity_boost": 42, 89 "style": 42, 90 "speed": 42 91 }, 92 "sharing": { 93 "status": "enabled", 94 "history_item_sample_id": "foo", 95 "date_unix": 42, 96 "whitelisted_emails": [ 97 "foo" 98 ], 99 "public_owner_id": "foo", 100 "original_voice_id": "foo", 101 "financial_rewards_enabled": true, 102 "free_users_allowed": true, 103 "live_moderation_enabled": true, 104 "rate": 42, 105 "fiat_rate": 42, 106 "notice_period": 42, 107 "disable_at_unix": 42, 108 "voice_mixing_allowed": true, 109 "featured": true, 110 "category": "generated", 111 "reader_app_enabled": true, 112 "image_url": "foo", 113 "ban_reason": "foo", 114 "liked_by_count": 42, 115 "cloned_by_count": 42, 116 "name": "foo", 117 "description": "foo", 118 "labels": {}, 119 "review_status": "not_requested", 120 "review_message": "foo", 121 "enabled_in_library": true, 122 "instagram_username": "foo", 123 "twitter_username": "foo", 124 "youtube_username": "foo", 125 "tiktok_username": "foo", 126 "moderation_check": { 127 "date_checked_unix": 42, 128 "name_value": "foo", 129 "name_check": true, 130 "description_value": "foo", 131 "description_check": true, 132 "sample_ids": [ 133 "foo" 134 ], 135 "sample_checks": [ 136 42 137 ], 138 "captcha_ids": [ 139 "foo" 140 ], 141 "captcha_checks": [ 142 42 143 ] 144 }, 145 "reader_restricted_on": [ 146 { 147 "resource_type": "read", 148 "resource_id": "foo" 149 } 150 ] 151 }, 152 "high_quality_base_model_ids": [ 153 "foo" 154 ], 155 "verified_languages": [ 156 { 157 "language": "foo", 158 "model_id": "foo", 159 "accent": "foo", 160 "locale": "foo", 161 "preview_url": "foo" 162 } 163 ], 164 "safety_control": "NONE", 165 "voice_verification": { 166 "requires_verification": true, 167 "is_verified": true, 168 "verification_failures": [ 169 "foo" 170 ], 171 "verification_attempts_count": 42, 172 "language": "foo", 173 "verification_attempts": [ 174 { 175 "text": "foo", 176 "date_unix": 42, 177 "accepted": true, 178 "similarity": 42, 179 "levenshtein_distance": 42, 180 "recording": { 181 "recording_id": "foo", 182 "mime_type": "foo", 183 "size_bytes": 42, 184 "upload_date_unix": 42, 185 "transcription": "foo" 186 } 187 } 188 ] 189 }, 190 "permission_on_resource": "foo", 191 "is_owner": true, 192 "is_legacy": false, 193 "is_mixed": false, 194 "created_at_unix": 42 195 } 196 ], 197 "has_more": true, 198 "total_count": 42, 199 "next_page_token": "foo" 200 }

Gets a list of all available voices for a user with search, filtering and pagination.

Query parameters

next_page_tokenstringOptional

The next page token to use for pagination. Returned from the previous request.

page_sizeintegerOptionalDefaults to 10

How many voices to return at maximum. Can not exceed 100, defaults to 10. Page 0 may include more voices due to default voices being included.

searchstringOptional

Search term to filter voices by. Searches in name, description, labels, category.

sortstringOptional

Which field to sort by, one of ‘created_at_unix’ or ‘name’. ‘created_at_unix’ may not be available for older voices.

sort_directionstringOptional

Which direction to sort the voices in. 'asc' or 'desc'.

voice_typestringOptional

Type of the voice to filter by. One of ‘personal’, ‘community’, ‘default’, ‘workspace’, ‘non-default’. ‘non-default’ is equal to all but ‘default’.

categorystringOptional

Category of the voice to filter by. One of 'premade', 'cloned', 'generated', 'professional'

fine_tuning_statestringOptional

State of the voice’s fine tuning to filter by. Applicable only to professional voices clones. One of ‘draft’, ‘not_verified’, ‘not_started’, ‘queued’, ‘fine_tuning’, ‘fine_tuned’, ‘failed’, ‘delayed’

collection_idstringOptional

Collection ID to filter voices by.

include_total_countbooleanOptionalDefaults to true

Whether to include the total count of voices found in the response. Incurs a performance cost.

Response

Successful Response

voiceslist of objects

has_moreboolean

total_countinteger

next_page_tokenstring or null

Headers

Query parameters

Response

Errors