解决boto3调用Amazon Nova模型时的ValidationException错误

在使用boto3 SDK调用Amazon Nova模型进行视频内容分析时，开发者可能会遇到一个常见的ValidationException错误。本文将深入分析这个问题的根源，并提供完整的解决方案。

问题现象

当开发者尝试通过boto3调用Amazon Nova模型的invoke_model方法处理视频文件时，系统会返回如下错误信息：

An error occurred (ValidationException) when calling the InvokeModel operation: Malformed input request: #/messages/0/content/1: required key [toolUse] not found, please reformat your input and try again.

这个错误信息具有一定的误导性，表面上看似乎是缺少了toolUse键，但实际上问题出在请求体的结构上。

错误原因分析

问题的核心在于请求体中视频数据的格式不正确。开发者通常会按照直觉将视频数据直接编码为base64字符串后放入请求体，如下所示：

{
    "video": {
        "format": "mp4",
        "bytes": base64_text
    }
}

然而，Amazon Nova API要求视频数据必须包含在一个"source"对象中，正确的格式应该是：

{
    "video": {
        "format": "mp4",
        "source": {
            "bytes": base64_text
        }
    }
}

完整解决方案

以下是修正后的完整代码示例，包含了正确的请求体结构：

import boto3
import os
import base64
import json

def analyze_video(video_filepath):
    with open(video_filepath, "rb") as video_file:
        base64_text = base64.b64encode(video_file.read()).decode("utf-8")
        try:
            bedrock = boto3.client(
                service_name="bedrock-runtime",
                region_name=os.getenv('BEDROCK_REGION')
            )
            
            body = [{
                "role": "user", 
                "content": [
                    {
                        "text": "请为这个视频生成一个合适的标题"
                    },
                    {
                        "video": {
                            "format": "mp4",
                            "source": {
                                "bytes": base64_text
                            }
                        }
                    }
                ]
            }]

            inf_params = {
                "maxTokens": 300,
                "topP": 0.9,
                "temperature": 0.7
            }

            modelId = 'us.amazon.nova-lite-v1:0'
            request_body = {
                "schemaVersion": "messages-v1",
                "messages": body,
                "inferenceConfig": inf_params,
            }
            
            response = bedrock.invoke_model(
                modelId=modelId,
                body=json.dumps(request_body)
            )
            
            response_body = json.loads(response.get("body").read())
            return response_body.get("content")
        
        except Exception as e:
            print(f"调用Amazon Nova模型时发生错误: {str(e)}")
            raise

关键改进点

1. 视频数据格式修正：将视频数据包装在"source"对象中，符合API规范
2. 错误处理优化：提供了更清晰的错误输出和处理逻辑
3. 代码结构优化：使代码更易读和维护

最佳实践建议

1. 在使用boto3调用AWS服务时，始终参考最新的官方文档
2. 对于复杂的API请求，可以先使用AWS CLI测试请求格式，再转换为boto3代码
3. 实现完善的错误处理和日志记录机制
4. 对于大视频文件，考虑使用流式处理或分块上传

通过遵循这些建议和正确的API格式，开发者可以顺利使用boto3调用Amazon Nova模型进行视频内容分析，避免常见的ValidationException错误。