Listar modelos

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
}

Liste os modelos de fluxos publicados no seu espaço de trabalho, junto com as entradas e saídas de cada versão executável. Use os IDs aqui como template_id / version_id em POST /v1/flows/templates/{template_id}/runs. Versões criadas com modelos que não estão disponíveis para você pela API são omitidas; portanto, versions fica vazio quando nenhuma das versões publicadas de um modelo pode ser executada por esta API. Modelos compartilhados com você por link ou publicados no Explore de outro espaço de trabalho não são listados, mas ainda podem ser buscados e executados por template_id.

Parâmetros de consulta

cursorstring or nullOpcional

Cursor de paginação: o valor de next_cursor da resposta da página anterior. Omita-o na primeira página.

page_sizeintegerOpcional1-25Padrão é 10

Quantos modelos retornar por página. O limite é menor que o da lista de execuções porque cada linha expande os esquemas de entrada e saída de suas versões.

versions_per_templateintegerOpcional1-10Padrão é 3

Quantas versões publicadas de cada modelo retornar, da mais recente para a mais antiga. has_more_versions informa quando um modelo tem mais versões.

searchstring or nullOpcional<=100 characters

Retorne apenas modelos cujo nome ou descrição contenha este texto.

Resposta

Resposta bem-sucedida

templateslist of objects

Os modelos nesta página, com os atualizados mais recentemente primeiro. Uma página pode conter menos de page_size modelos, ou nenhum, porque os modelos que você não pode executar são filtrados depois que a página é lida — continue paginando enquanto has_more for verdadeiro.

next_cursorstring or null

Passe como cursor para buscar a próxima página. null quando não houver outra página.

has_morebooleanSomente leitura

Se existem mais modelos além desta página.

Erros

422

Unprocessable Entity Error

Cabeçalhos

Parâmetros de consulta

Resposta

Erros