AWS Bedrock

先分清托管平台与模型厂商

Amazon Bedrock 是 AWS 托管的多厂商基础模型平台，不是模型原厂。同一个 AWS 服务中可以出现 Amazon、Anthropic、Meta、Mistral 等来源的模型；模型作者、许可证、区域、能力和价格必须按精确 modelId 与官方模型页核验。本站 /v1/chat/completions 是已适配的网关入口，不是 Bedrock 原生 URL，且只代表当前渠道实际开放的模型。

直连有两类认证

传统方式使用 IAM 凭证并对请求做 AWS Signature Version 4（SigV4）签名。Bedrock 也支持 API Key：短期 key 继承 IAM 权限和区域，有效期不超过 12 小时（也受当前 IAM 会话时长约束），AWS 将短期凭证作为生产优先选择；长期 key 更适合快速探索，生产前应换成短期凭证并落实最小权限、轮换和秘密管理。Bedrock API Key 的 Bearer 值、AWS IAM 凭证与本站 API Key 互不通用。

模型访问可能包含订阅与 EULA

账号有 API 权限不等于每个第三方模型都可立即调用。首次调用第三方模型可能自动发起 AWS Marketplace 订阅，并意味着接受相应最终用户许可协议；部分提供商还要求完成首次使用信息。遇到 AccessDeniedException 时，应同时检查 IAM、Marketplace 权限、区域、模型访问条件和提供商要求，不能只轮换密钥。

Converse、InvokeModel 与异步任务怎么选

Converse/ConverseStream 提供跨模型较统一的消息结构，适合对话与需要降低迁移成本的应用，但不代表所有模型支持同样的工具和内容类型。InvokeModel/InvokeModelWithResponseStream 使用模型原生请求体，适合需要提供商特有参数的同步或流式推理。视频等异步能力使用 StartAsyncInvoke 创建任务，再查询结果；不要用同步响应解析器等待异步任务完成。

modelId 不一定只是基础模型名

调用参数可能是基础模型 ID 或 ARN、inference profile、provisioned throughput、自定义模型部署等资源标识。复制示例前先确认目标区域和推理方式，保存实际资源标识、请求 ID、延迟与用量；公开别名或版本变化时要做回归测试。

限流、成本与安全

401/403 先检查认证、IAM 与模型访问，404 检查区域和资源标识，429 按 AWS 返回信息降低并发，临时 5xx 才做带抖动的有限指数退避。配置服务配额、预算告警、CloudTrail/CloudWatch、输入输出上限与敏感数据策略；Guardrails 是附加控制，不替代应用自己的授权、审计和内容安全。