Vorlagen auflisten

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
}

Listet die veröffentlichten Flows-Vorlagen in Ihrem Workspace zusammen mit den Eingaben und Ausgaben jeder ausführbaren Version auf. Verwenden Sie die IDs hier als template_id / version_id bei POST /v1/flows/templates/{template_id}/runs. Versionen, die auf Modellen basieren, die Ihnen über die API nicht zur Verfügung stehen, werden ausgelassen. Daher ist versions leer, wenn keine veröffentlichte Version einer Vorlage über diese API ausführbar ist. Vorlagen, die per Link mit Ihnen geteilt oder aus einem anderen Workspace in Explore veröffentlicht wurden, werden nicht aufgelistet, können aber weiterhin über template_id abgerufen und ausgeführt werden.

Listet die veröffentlichten Flows-Vorlagen in Ihrem Workspace zusammen mit den Eingaben und Ausgaben jeder ausführbaren Version auf. Verwenden Sie die IDs hier als `template_id` / `version_id` bei `POST /v1/flows/templates/{template_id}/runs`. Versionen, die auf Modellen basieren, die Ihnen über die API nicht zur Verfügung stehen, werden ausgelassen. Daher ist `versions` leer, wenn keine veröffentlichte Version einer Vorlage über diese API ausführbar ist. Vorlagen, die per Link mit Ihnen geteilt oder aus einem anderen Workspace in Explore veröffentlicht wurden, werden nicht aufgelistet, können aber weiterhin über `template_id` abgerufen und ausgeführt werden.

Abfrageparameter

cursorstring or nullOptional

Paginierungs-Cursor: der Wert next_cursor aus der Antwort der vorherigen Seite. Lassen Sie ihn für die erste Seite weg.

page_sizeintegerOptional1-25Standardwert ist 10

Wie viele Vorlagen pro Seite zurückgegeben werden sollen. Niedriger als das Limit der Ausführungsliste, da jede Zeile die Eingabe- und Ausgabeschemas ihrer Versionen erweitert.

versions_per_templateintegerOptional1-10Standardwert ist 3

Wie viele veröffentlichte Versionen jeder Vorlage zurückgegeben werden sollen, neueste zuerst. has_more_versions zeigt an, wenn eine Vorlage weitere Versionen hat.

searchstring or nullOptional<=100 characters

Nur Vorlagen zurückgeben, deren Name oder Beschreibung diesen Text enthält.

Antwort

Erfolgreiche Antwort

templateslist of objects

Die Templates auf dieser Seite, mit den zuletzt aktualisierten zuerst. Eine Seite kann weniger als page_size Templates oder gar keine enthalten, da Templates, die Sie nicht ausführen können, nach dem Lesen der Seite herausgefiltert werden — rufen Sie weitere Seiten ab, solange has_more true ist.

next_cursorstring or null

Als cursor übergeben, um die nächste Seite abzurufen. null, wenn es keine weitere Seite gibt.

has_morebooleanSchreibgeschützt

Gibt an, ob weitere Vorlagen nach dieser Seite vorhanden sind.

Fehler

422

Unprocessable Entity Error

Header

Abfrageparameter

Antwort

Fehler