Templates weergeven

GET

/v1/flows/templates

GET

/v1/flows/templates

curl https://api.elevenlabs.io/v1/flows/templates

{
  "templates": [
    {
      "id": "tmpl_abc123",
      "name": "Product shot",
      "versions": [
        {
          "version_id": "ver_01hxyz",
          "published_at_unix": 1739721600,
          "is_latest": true,
          "inputs": [
            {
              "id": "prompt",
              "content_schema": {
                "type": "string",
                "title": "Prompt"
              }
            },
            {
              "id": "reference",
              "content_schema": {
                "type": "image",
                "description": "A clean product photo on any background.",
                "title": "Product photo"
              }
            }
          ],
          "outputs": [
            {
              "id": "product_still",
              "content_schema": {
                "type": "image",
                "title": "Final image"
              }
            }
          ]
        }
      ],
      "has_more_versions": false,
      "description": "Drop in a product photo, get a studio shot."
    }
  ],
  "next_cursor": "cGFnZXwx",
  "has_more": true
}

Lijst de gepubliceerde flowtemplates in je workspace op, samen met de invoer en uitvoer van elke uitvoerbare versie. Gebruik de id’s hier als template_id / version_id bij POST /v1/flows/templates/{template_id}/runs. Versies die zijn gebouwd op modellen die voor jou niet beschikbaar zijn via de API, worden weggelaten. Daarom is versions leeg wanneer geen van de gepubliceerde versies van een template via deze API kan worden uitgevoerd. Templates die via een link met je zijn gedeeld of vanuit een andere workspace naar Explore zijn gepubliceerd, worden niet vermeld, maar kunnen nog steeds worden opgehaald en uitgevoerd via template_id.

Query parameters

cursorstring or nullOptional

Pagineringcursor: de waarde next_cursor uit het antwoord van de vorige pagina. Laat deze weg voor de eerste pagina.

page_sizeintegerOptional1-25Defaults to 10

Het aantal templates dat per pagina moet worden geretourneerd. Lager dan de limiet van de runlijst, omdat elke rij de invoer- en uitvoerschema’s van de versies uitbreidt.

versions_per_templateintegerOptional1-10Defaults to 3

Hoeveel gepubliceerde versies van elke template moeten worden geretourneerd, nieuwste eerst. has_more_versions geeft aan wanneer een template er meer heeft.

searchstring or nullOptional<=100 characters

Retourneer alleen templates waarvan de naam of beschrijving deze tekst bevat.

Response

Geslaagde response

templateslist of objects

De templates op deze pagina, met de meest recent bijgewerkte eerst. Een pagina kan minder dan page_size templates bevatten, of helemaal geen, omdat templates die je niet kunt uitvoeren worden weggefilterd nadat de pagina is gelezen — blijf pagineren zolang has_more true is.

next_cursorstring or null

Geef door als cursor om de volgende pagina op te halen. null als er geen volgende pagina is.

has_morebooleanRead-only

Of er na deze pagina meer templates bestaan.

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Response

Errors