翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# TwelveLabs Pegasus 1.2
<a name="model-parameters-pegasus"></a>

TwelveLabs Pegasus 1.2 モデルは、包括的な動画の理解と分析機能を提供します。動画コンテンツを分析し、テキストによる説明、インサイト、動画に関する質問への回答を生成できます。

この情報を使用して、InvokeModel オペレーションと InvokeModelWithResponseStream (ストリーミング) オペレーションで TwelveLabs モデルに推論呼び出しを実行できます。
+ プロバイダー — TwelveLabs
+ カテゴリ — 動画の理解、コンテンツ分析
+ モデル ID — `twelvelabs.pegasus-1-2-v1:0`
+ 入力モダリティ — 動画
+ 出力モダリティ — テキスト
+ 最大動画サイズ — 1 時間の長さの動画 (ファイルサイズ 2GB 以下)

## TwelveLabs Pegasus 1.2 リクエストパラメータ
<a name="model-parameters-pegasus-request"></a>

TwelveLabs Pegasus 1.2 モデルの入力パラメータは、次の表のとおりです。


**TwelveLabs Pegasus 1.2 リクエストパラメータ**  

| フィールド | Type | 必須 | 説明 | 
| --- | --- | --- | --- | 
| inputPrompt | 文字列 | はい | 動画分析用プロンプト 最大: 2,000 トークン | 
| temperature | double | いいえ | モデルの温度。出力のランダム性を制御します。デフォルト: 0.2、最低: 0、最大: 1 | 
| responseFormat | オブジェクト | いいえ | ユーザーが構造化出力形式を指定できるようにします。現時点でサポートされているのは、json\_schema のみです。 | 
| mediaSource | オブジェクト | はい | メディアソースについての説明。base64String または s3Location を提供する必要があります。 | 
| mediaSource.base64String | string | いいえ | 動画用 Base64 でエンコードされたバイト文字列。最大: 25MB。 | 
| mediaSource.s3Location.uri | string | いいえ | 動画のダウンロード元 S3 URI。最大: 1 時間の長さの動画 (ファイルサイズ 2GB 以下) | 
| mediaSource.s3Location.bucketOwner | string | いいえ | バケット所有者の AWS アカウント ID | 
| maxOutputTokens | integer | いいえ | 生成するトークンの最大数。最大: 4,096 | 

## TwelveLabs Pegasus 1.2 応答フィールド
<a name="model-parameters-pegasus-response"></a>

TwelveLabs Pegasus 1.2 モデルの出力フィールドは、次の表のとおりです。


**TwelveLabs Pegasus 1.2 応答フィールド**  

| フィールド | タイプ | 説明 | 
| --- | --- | --- | 
| message | string | モデルの動画分析を含む出力メッセージ | 
| finishReason | string | 出力が終了した原因を説明する停止理由。有効な値: stop (API が制限に達することなく完全な完了を返しました)、length (生成が max\_tokens の制限を超えました) | 

## TwelveLabs Pegasus 1.2 のリクエストとレスポンス
<a name="model-parameters-pegasus-examples"></a>

次の例は、さまざまな入力ソースで TwelveLabs Pegasus 1.2 モデルを使用する方法を説明しています。

------
#### [ Request ]

次の例は、TwelveLabs Pegasus 1.2 モデルのリクエストを説明しています。

**base64 でエンコードされた動画の使用:**

```
{
  "inputPrompt": "tell me about the video",
  "mediaSource": {
      "base64String": "<BASE64 STRING OF VIDEO FILE>"
  },
  "temperature": 0
}
```

**S3 に保存された動画の使用:**

```
{
    "inputPrompt": "Tell me about this video",
    "mediaSource": {
        "s3Location": {
            "uri": "s3://path-to-video-object-in-s3",
            "bucketOwner": "bucket-owner-account-id"
        }
    },
    "temperature": 0
}
```

**構造化出力形式の使用:**

```
{
    "inputPrompt": "Analyze this video and provide a structured summary",
    "mediaSource": {
        "s3Location": {
            "uri": "s3://path-to-video-object-in-s3",
            "bucketOwner": "bucket-owner-account-id"
        }
    },
    "temperature": 0.2,
    "maxOutputTokens": 2048,
    "responseFormat": {
        "type": "json_schema",
        "jsonSchema": {
            "name": "video_analysis",
            "schema": {
                "type": "object",
                "properties": {
                    "summary": {"type": "string"},
                    "key_scenes": {"type": "array", "items": {"type": "string"}},
                    "duration": {"type": "string"}
                },
                "required": ["summary", "key_scenes"]
            }
        }
    }
}
```

------
#### [ Response ]

次の例は、TwelveLabs Pegasus 1.2 モデルからのレスポンス形式を説明しています。

**標準的なレスポンス:**

```
{
  "message": "This video shows a person walking through a park during sunset. The scene includes trees, a walking path, and golden lighting from the setting sun. The person appears to be enjoying a peaceful evening stroll.",
  "finishReason": "stop"
}
```

**構造化された出力のレスポンス:**

```
{
  "message": "{\"summary\": \"A peaceful evening walk through a park at sunset\", \"key_scenes\": [\"Person entering the park\", \"Walking along tree-lined path\", \"Sunset lighting through trees\", \"Person sitting on bench\"], \"duration\": \"Approximately 2 minutes\"}",
  "finishReason": "stop"
}
```

**最大トークン数に達した場合のレスポンス:**

```
{
  "message": "This video contains multiple scenes showing various activities. The first scene shows...",
  "finishReason": "length"
}
```

------