템플릿 목록

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
}

워크스페이스에 게시된 플로우 템플릿과 각 실행 가능 버전의 입력 및 출력을 나열합니다. 여기의 ID를 POST /v1/flows/templates/{template_id}/runs에서 template_id / version_id로 사용하세요. API를 통해 사용할 수 없는 모델을 기반으로 빌드된 버전은 제외되므로, 템플릿의 게시된 버전 중 이 API로 실행할 수 있는 버전이 없으면 versions는 비어 있습니다. 링크로 공유받았거나 다른 워크스페이스에서 Explore에 게시된 템플릿은 나열되지 않지만, template_id로 계속 가져오고 실행할 수 있습니다.

워크스페이스에 게시된 플로우 템플릿과 각 실행 가능 버전의 입력 및 출력을 나열합니다. 여기의 ID를 `POST /v1/flows/templates/{template_id}/runs`에서 `template_id` / `version_id`로 사용하세요. API를 통해 사용할 수 없는 모델을 기반으로 빌드된 버전은 제외되므로, 템플릿의 게시된 버전 중 이 API로 실행할 수 있는 버전이 없으면 `versions`는 비어 있습니다. 링크로 공유받았거나 다른 워크스페이스에서 Explore에 게시된 템플릿은 나열되지 않지만, `template_id`로 계속 가져오고 실행할 수 있습니다.

쿼리 매개변수

cursorstring or null선택 사항

페이지네이션 커서입니다. 이전 페이지 응답의 next_cursor 값입니다. 첫 페이지에서는 생략하세요.

page_sizeinteger선택 사항1-25기본값 10

페이지당 반환할 템플릿 수입니다. 각 행이 버전의 입력 및 출력 스키마를 확장하므로 실행 목록의 상한보다 낮습니다.

versions_per_templateinteger선택 사항1-10기본값 3

각 템플릿의 게시된 버전을 최신순으로 몇 개 반환할지 지정합니다. 템플릿에 버전이 더 있으면 has_more_versions가 이를 알려줍니다.

searchstring or null선택 사항<=100 characters

이 텍스트를 이름 또는 설명에 포함하는 템플릿만 반환합니다.

응답

성공 응답

templateslist of objects

이 페이지의 템플릿이며, 가장 최근에 업데이트된 항목부터 표시됩니다. 실행할 수 없는 템플릿은 페이지를 읽은 후 필터링되므로, 페이지에는 page_size보다 적은 템플릿이 있거나 전혀 없을 수 있습니다. has_more가 true인 동안 계속 페이지를 조회하세요.

next_cursorstring or null

다음 페이지를 가져오기 위해 cursor로 전달합니다. 다음 페이지가 없으면 null입니다.

has_moreboolean읽기 전용

이 페이지 이후에 더 많은 템플릿이 있는지 여부입니다.

오류

422

Unprocessable Entity Error

헤더

쿼리 매개변수

응답

오류