Listar plantillas

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
}

Enumera las plantillas de flujos publicadas en tu espacio de trabajo, junto con las entradas y salidas de cada versión ejecutable. Usa los ID de aquí como template_id / version_id en POST /v1/flows/templates/{template_id}/runs. Se omiten las versiones creadas con modelos que no tienes disponibles a través de la API, por lo que versions estará vacío si ninguna versión publicada de una plantilla puede ejecutarse mediante esta API. Las plantillas compartidas contigo mediante enlace o publicadas en Explore desde otro espacio de trabajo no aparecen en la lista, pero aun así puedes obtenerlas y ejecutarlas mediante template_id.

Enumera las plantillas de flujos publicadas en tu espacio de trabajo, junto con las entradas y salidas de cada versión ejecutable. Usa los ID de aquí como `template_id` / `version_id` en `POST /v1/flows/templates/{template_id}/runs`. Se omiten las versiones creadas con modelos que no tienes disponibles a través de la API, por lo que `versions` estará vacío si ninguna versión publicada de una plantilla puede ejecutarse mediante esta API. Las plantillas compartidas contigo mediante enlace o publicadas en Explore desde otro espacio de trabajo no aparecen en la lista, pero aun así puedes obtenerlas y ejecutarlas mediante `template_id`.

Parámetros de consulta

cursorstring or nullOpcional

Cursor de paginación: el valor next_cursor de la respuesta de la página anterior. Omítelo en la primera página.

page_sizeintegerOpcional1-25Valor predeterminado: 10

Cuántas plantillas se devolverán por página. El límite es inferior al de la lista de ejecuciones porque cada fila expande los esquemas de entrada y salida de sus versiones.

versions_per_templateintegerOpcional1-10Valor predeterminado: 3

Cuántas versiones publicadas de cada plantilla se devolverán, primero las más recientes. has_more_versions indica cuándo una plantilla tiene más versiones.

searchstring or nullOpcional<=100 characters

Devolver solo plantillas cuyo nombre o descripción contenga este texto.

Respuesta

Respuesta correcta.

templateslist of objects

Las plantillas de esta página, ordenadas de la actualización más reciente a la más antigua. Una página puede contener menos de page_size plantillas, o ninguna, porque las plantillas que no puedes ejecutar se filtran después de leer la página; sigue paginando mientras has_more sea true.

next_cursorstring or null

Pásalo como cursor para obtener la página siguiente. null cuando no hay más páginas.

has_morebooleanSolo lectura

Indica si hay más plantillas después de esta página.

Errores

422

Unprocessable Entity Error

Encabezados

Parámetros de consulta

Respuesta

Errores