Gegenereerde items ophalen

GET

/v1/history

GET

/v1/history

curl -G https://api.elevenlabs.io/v1/history \
     -d date_after_unix=1640995200 \
     -d date_before_unix=1640995200 \
     -d model_id=eleven_turbo_v2 \
     --data-urlencode "search=In the land far far away" \
     -d sort_direction=desc \
     -d source=TTS

{
  "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
}

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.

Query parameters

page_sizeintegerOptionalDefaults to 100

Het maximale aantal geschiedenisitems dat moet worden geretourneerd. Mag niet meer zijn dan 1000; standaard is dit 100.

start_after_history_item_idstring or nullOptional

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_idstring or nullOptional

ID van de stem waarop moet worden gefilterd. Je kunt het endpoint Stemmen ophalen gebruiken om alle beschikbare stemmen weer te geven.

model_idstring or nullOptional

Zoekterm die wordt gebruikt om geschiedenisitems te filteren. Als deze is opgegeven, is source verplicht.

date_before_unixinteger or nullOptional

Unix-timestamp om geschiedenisitems vóór deze datum te filteren (exclusief).

date_after_unixinteger or nullOptional

Unix-timestamp om geschiedenisitems na deze datum te filteren (inclusief).

sort_directionenum or nullOptionalDefaults to desc

Sorteerrichting voor de resultaten.

Allowed values:

searchstring or nullOptional

zoekterm die wordt gebruikt voor filtering

sourceenum or nullOptional

Bron van het gegenereerde geschiedenisitem

Allowed values:

Response

Geslaagde response

historylist of objects

Een lijst met spraakgeschiedenisitems.

has_moreboolean

Of er meer geschiedenisitems kunnen worden opgehaald.

last_history_item_idstring or nullOptional

De ID van het laatste geschiedenisitem.

scanned_untilinteger or nullOptional

De timestamp van het laatste geschiedenisitem.

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Response

Errors