テンプレートを一覧表示

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

1ページあたりに返すテンプレート数です。各行でバージョンの入力・出力スキーマが展開されるため、実行リストの上限より低く設定されています。

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

ヘッダー

クエリパラメータ

レスポンス

エラー