

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

El modelo TwelveLabs Pegasus 1.2 proporciona capacidades integrales de comprensión y análisis de vídeo. Puede analizar el contenido de vídeo y generar descripciones textuales, información y respuestas a preguntas sobre el vídeo.

Utilice esta información para realizar llamadas de inferencia a TwelveLabs los modelos con las InvokeModel operaciones InvokeModelWithResponseStream (de transmisión).
+ Proveedor: TwelveLabs
+ Categorías: comprensión del vídeo, análisis de contenido
+ ID de modelo: `twelvelabs.pegasus-1-2-v1:0`
+ Modalidad de entrada: vídeo
+ Modalidad de salida: texto
+ Tamaño máximo del vídeo: vídeo de 1 hora de duración (tamaño de archivo inferior a 2 GB)

## Parámetros de solicitud de TwelveLabs Pegasus 1.2
<a name="model-parameters-pegasus-request"></a>

En la siguiente tabla se describen los parámetros de entrada para el modelo TwelveLabs Pegasus 1.2:


**Parámetros de solicitud de TwelveLabs Pegasus 1.2**  

| Campo | Tipo | Obligatorio | Descripción | 
| --- | --- | --- | --- | 
| inputPrompt | string | Sí | Petición para analizar el vídeo. 2000 tokens como máximo | 
| temperature | double | No | Temperatura del modelo. Controla la asignación al azar de la salida. Predeterminado: 0,2, mínimo: 0, máximo: 1. | 
| responseFormat | Objeto | No | Permite a los usuarios especificar el formato de salida estructurado. Actualmente solo admite json\$1schema. | 
| mediaSource | objeto | Sí | Describe el origen del contenido multimedia. Se debe proporcionar base64String o s3Location. | 
| mediaSource.base64String | cadena | No | Cadena de bytes codificada en Base64 para el vídeo. Máximo: 25 MB. | 
| mediaSource.s3Location.uri | cadena | No | La URI de S3 desde donde se puede descargar el vídeo. Máximo: vídeo de 1 hora de duración (tamaño de archivo inferior a 2 GB) | 
| mediaSource.s3Location.bucketOwner | cadena | No | ID de la cuenta de AWS del propietario del bucket. | 
| maxOutputTokens | entero | No | El número máximo de tokens que se generarán. Máx.: 4096. | 

## Campos de respuesta de TwelveLabs Pegasus 1.2
<a name="model-parameters-pegasus-response"></a>

En la siguiente tabla se describen los campos de salida del modelo TwelveLabs Pegasus 1.2:


**Campos de respuesta de TwelveLabs Pegasus 1.2**  

| Campo | Tipo | Description (Descripción) | 
| --- | --- | --- | 
| message | cadena | Mensaje de salida que contiene el análisis del vídeo realizado por el modelo. | 
| finishReason | cadena | Motivo de la parada que describe por qué finalizó la salida. Valores válidos: stop (la API devolvió las finalizaciones completas sin alcanzar ningún límite), length (la generación superó el límite de max\$1tokens). | 

## Solicitud y respuesta de TwelveLabs Pegasus 1.2
<a name="model-parameters-pegasus-examples"></a>

En los siguientes ejemplos se muestra cómo usar el modelo TwelveLabs Pegasus 1.2 con diferentes orígenes de entrada.

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

En los siguientes ejemplos se muestran los formatos de solicitud del modelo TwelveLabs Pegasus 1.2.

**Uso de vídeo codificado en base64:**

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

**Uso de vídeo almacenado en S3:**

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

**Uso de formato de salida estructurado:**

```
{
    "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",
        "json_schema": {
            "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 ]

En los siguientes ejemplos se muestran los formatos de respuesta del modelo TwelveLabs Pegasus 1.2.

**Respuesta estándar:**

```
{
  "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"
}
```

**Respuesta con salida estructurada:**

```
{
  "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"
}
```

**Respuesta cuando se alcanza el máximo de tokens:**

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

------