Lister les modèles

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
}

Répertorie les modèles de flux publiés dans votre Workspace, ainsi que les entrées et sorties de chaque version exécutable. Utilisez les identifiants indiqués ici comme template_id / version_id dans POST /v1/flows/templates/{template_id}/runs. Les versions basées sur des modèles auxquels vous n’avez pas accès via l’API sont exclues. versions est donc vide lorsqu’aucune version publiée d’un modèle n’est exécutable via cette API. Les modèles partagés avec vous par lien ou publiés dans Explore depuis un autre Workspace ne sont pas répertoriés, mais peuvent toujours être récupérés et exécutés à l’aide de template_id.

Répertorie les modèles de flux publiés dans votre Workspace, ainsi que les entrées et sorties de chaque version exécutable. Utilisez les identifiants indiqués ici comme `template_id` / `version_id` dans `POST /v1/flows/templates/{template_id}/runs`. Les versions basées sur des modèles auxquels vous n’avez pas accès via l’API sont exclues. `versions` est donc vide lorsqu’aucune version publiée d’un modèle n’est exécutable via cette API. Les modèles partagés avec vous par lien ou publiés dans Explore depuis un autre Workspace ne sont pas répertoriés, mais peuvent toujours être récupérés et exécutés à l’aide de `template_id`.

Paramètres de requête

cursorstring or nullOptionnel

Curseur de pagination : valeur next_cursor de la réponse de la page précédente. Omettez-le pour la première page.

page_sizeintegerOptionnel1-25Par défaut 10

Nombre de modèles à renvoyer par page. Cette valeur est inférieure au plafond de la liste des exécutions, car chaque ligne développe les schémas d’entrée et de sortie de ses versions.

versions_per_templateintegerOptionnel1-10Par défaut 3

Nombre de versions publiées de chaque modèle à renvoyer, de la plus récente à la plus ancienne. has_more_versions indique si un modèle en comporte davantage.

searchstring or nullOptionnel<=100 characters

Renvoyer uniquement les modèles dont le nom ou la description contient ce texte.

Réponse

Réponse réussie

templateslist of objects

Les modèles de cette page, classés du plus récemment mis à jour au moins récent. Une page peut contenir moins de page_size modèles, voire aucun, car les modèles que vous ne pouvez pas exécuter sont filtrés après la lecture de la page. Continuez la pagination tant que has_more est vrai.

next_cursorstring or null

Transmettez comme cursor pour récupérer la page suivante. null lorsqu’il n’y a pas de page supplémentaire.

has_morebooleanLecture seule

Indique si d’autres modèles existent après cette page.

Erreurs

422

Unprocessable Entity Error

En-têtes

Paramètres de requête

Réponse

Erreurs