Wyświetl szablony

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
}

Wyświetla opublikowane szablony flows w workspace wraz z wejściami i wyjściami każdej uruchamialnej wersji. Użyj tych identyfikatorów jako template_id / version_id w POST /v1/flows/templates/{template_id}/runs. Wersje oparte na modelach niedostępnych przez API są pomijane, więc versions jest puste, gdy żadnej opublikowanej wersji szablonu nie można uruchomić przez to API. Szablony udostępnione ci linkiem lub opublikowane w Explore z innego workspace nie są wyświetlane, ale nadal można je pobrać i uruchomić przez template_id.

Parametry zapytania

cursorstring or nullOpcjonalny

Kursor paginacji: wartość next_cursor z odpowiedzi poprzedniej strony. Pomiń go dla pierwszej strony.

page_sizeintegerOpcjonalny1-25Domyślnie 10

Ile szablonów zwrócić na stronę. Limit jest niższy niż dla listy uruchomień, ponieważ każdy wiersz rozwija schematy wejścia i wyjścia swoich wersji.

versions_per_templateintegerOpcjonalny1-10Domyślnie 3

Ile opublikowanych wersji każdego szablonu zwrócić, od najnowszych. has_more_versions wskazuje, czy szablon ma więcej wersji.

searchstring or nullOpcjonalny<=100 characters

Zwracaj tylko szablony, których nazwa lub opis zawiera ten tekst.

Odpowiedź

Pomyślna odpowiedź

templateslist of objects

Szablony na tej stronie, od ostatnio zaktualizowanych. Strona może zawierać mniej niż page_size szablonów albo nie zawierać ich wcale, ponieważ szablony, których nie możesz uruchomić, są odfiltrowywane po odczytaniu strony — pobieraj kolejne strony, dopóki has_more ma wartość true.

next_cursorstring or null

Przekaż jako cursor, aby pobrać następną stronę. null, gdy nie ma kolejnej strony.

has_morebooleanTylko do odczytu

Czy poza tą stroną istnieją kolejne szablony.

Błędy

422

Unprocessable Entity Error

Nagłówki

Parametry zapytania

Odpowiedź

Błędy