> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Gegenereerde items ophalen GET https://api.elevenlabs.io/v1/history Retourneert een lijst met je gegenereerde audio (bijvoorbeeld Text to Speech, speech-to-speech, Studio, nasynchronisatie). Muziek- en SFX-generaties zijn niet inbegrepen en kunnen momenteel niet via de API worden opgehaald. Reference: https://elevenlabs.io/docs/api-reference/history/list ## Servers - `https://api.elevenlabs.io` (Production, default) - `https://api.us.elevenlabs.io` (Production US) - `https://api.eu.residency.elevenlabs.io` (Production EU) - `https://api.in.residency.elevenlabs.io` (Production India) - `https://api.sg.residency.elevenlabs.io` (Production Singapore) ## Request ### Query parameters - `page_size` (integer, optional, default: 100) — Het maximale aantal geschiedenisitems dat moet worden geretourneerd. Mag niet meer zijn dan 1000; standaard is dit 100. - `start_after_history_item_id` (string, optional, nullable) — Na welke ID het ophalen moet beginnen. Gebruik deze parameter om door een grote verzameling geschiedenisitems te pagineren. Als deze parameter niet wordt opgegeven, worden geschiedenisitems opgehaald vanaf het meest recent gemaakte item, aflopend gesorteerd op aanmaakdatum. - `voice_id` (string, optional, nullable) — ID van de stem waarop moet worden gefilterd. Je kunt het endpoint [Stemmen ophalen](/docs/api-reference/voices/search) gebruiken om alle beschikbare stemmen weer te geven. - `model_id` (string, optional, nullable) — Zoekterm die wordt gebruikt om geschiedenisitems te filteren. Als deze is opgegeven, is source verplicht. - `date_before_unix` (integer, optional, nullable) — Unix-timestamp om geschiedenisitems vóór deze datum te filteren (exclusief). - `date_after_unix` (integer, optional, nullable) — Unix-timestamp om geschiedenisitems na deze datum te filteren (inclusief). - `sort_direction` (enum, optional, nullable, default: desc) — Sorteerrichting voor de resultaten. - Allowed values: `asc`, `desc` - `search` (string, optional, nullable) — zoekterm die wordt gebruikt voor filtering - `source` (enum, optional, nullable) — Bron van het gegenereerde geschiedenisitem - Allowed values: `TTS`, `STS`, `Flows` ## Response ### 200 Geslaagde response - `history` (list of SpeechHistoryItemResponseModel, required) — Een lijst met spraakgeschiedenisitems. - `has_more` (boolean, required) — Of er meer geschiedenisitems kunnen worden opgehaald. - `last_history_item_id` (string, optional, nullable) — De ID van het laatste geschiedenisitem. - `scanned_until` (integer, optional, nullable) — De timestamp van het laatste geschiedenisitem. ## Errors ### 422 Unprocessable Entity Error Validatiefout - `detail` (list of ValidationError, optional) ## Types ### SpeechHistoryItemResponseModel - `history_item_id` (string, required) — De ID van het geschiedenisitem. - `date_unix` (integer, required) — Unix-timestamp waarop het item is gemaakt. - `character_count_change_from` (integer, required) — De oorspronkelijke wijziging van het aantal tekens. - `character_count_change_to` (integer, required) — De nieuwe wijziging van het aantal tekens. - `content_type` (string, required) — Het contenttype van het gegenereerde item. - `state` (any, required) - `request_id` (string, optional, nullable) — De ID van de request. - `voice_id` (string, optional, nullable) — De ID van de gebruikte stem. - `model_id` (string, optional, nullable) — De ID van het model. - `voice_name` (string, optional, nullable) — De naam van de stem. - `voice_category` (enum, optional, nullable) — De categorie van de stem. Dit is 'premade', 'cloned', 'generated' of 'professional'. - Allowed values: `premade`, `cloned`, `generated`, `professional` - `text` (string, optional, nullable) — De tekst die is gebruikt om het audio-item te genereren. - `settings` (map from string to any, optional, nullable) — De instellingen van het geschiedenisitem. - `share_link_id` (string, optional, nullable) — De ID van de deellink. - `source` (enum, optional, nullable) — De bron van het geschiedenisitem. TTS (text to speech), STS (speech to text), AN (audio native), Projects, Dubbing, PlayAPI, PD (uitspraakwoordenboek) of ConvAI (Agents Platform). - Allowed values: `TTS`, `STS`, `Projects`, `PD`, `AN`, `Dubbing`, `PlayAPI`, `ConvAI`, `VoiceGeneration`, `InVPC`, `Flows`, `VoicePreview` - `alignments` (HistoryAlignmentsResponseModel, optional, nullable) — De uitlijningen van het geschiedenisitem. - `dialogue` (list of DialogueInputResponseModel, optional, nullable) — De dialoog (stem- en tekstparen) die is gebruikt om het audio-item te genereren. Als dit is ingesteld, zijn de velden `text` en `voice_id` op het hoogste niveau leeg. - `output_format` (string, optional, nullable) — Het uitvoerformaat waarin de audio oorspronkelijk is gegenereerd. ### ValidationError - `loc` (list of ValidationErrorLocItems, required) - `msg` (string, required) - `type` (string, required) ### HistoryAlignmentsResponseModel - `alignment` (HistoryAlignmentResponseModel, required) — De uitlijning van de tekst. - `normalized_alignment` (HistoryAlignmentResponseModel, required) — De genormaliseerde uitlijning van de tekst. ### DialogueInputResponseModel - `text` (string, required) — De tekst van de dialooginvoerregel. - `voice_id` (string, required) — De ID van de stem die voor deze dialooginvoerregel wordt gebruikt. - `voice_name` (string, required) — De naam van de stem die voor deze dialooginvoerregel wordt gebruikt. ### ValidationErrorLocItems ### HistoryAlignmentResponseModel - `characters` (list of string, required) — De tekens in de alignment. - `character_start_times_seconds` (list of double, required) — De starttijden van de tekens in seconden. - `character_end_times_seconds` (list of double, required) — De eindtijden van de tekens in seconden. ## Examples **Response** ```json { "history": [ { "history_item_id": "ja9xsmfGhxYcymxGcOGB", "date_unix": 1714650306, "character_count_change_from": 17189, "character_count_change_to": 17231, "content_type": "audio/mpeg", "state": null, "request_id": "BF0BZg4IwLGBlaVjv9Im", "voice_id": "21m00Tcm4TlvDq8ikWAM", "model_id": "eleven_multilingual_v2", "voice_name": "Rachel", "voice_category": "premade", "text": "Hello, world!", "settings": { "similarity_boost": 0.5, "stability": 0.71, "style": 0, "use_speaker_boost": true }, "source": "TTS" } ], "has_more": true, "last_history_item_id": "ja9xsmfGhxYcymxGcOGB", "scanned_until": 1714650306 } ``` **SDK Code** ```python import requests url = "https://api.elevenlabs.io/v1/history" querystring = {"date_after_unix":"1640995200","date_before_unix":"1640995200","model_id":"eleven_turbo_v2","search":"In the land far far away","sort_direction":"desc","source":"TTS"} response = requests.get(url, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS'; const options = {method: 'GET'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS") .asString(); ``` ```php request('GET', 'https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS'); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/history?date_after_unix=1640995200&date_before_unix=1640995200&model_id=eleven_turbo_v2&search=In+the+land+far+far+away&sort_direction=desc&source=TTS")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```