API restrictions - Amazon Bedrock

API restrictions

The following restrictions apply to the InvokeModel, InvokeModelWithResponseStream, Converse, and ConverseStream operations. Some restrictions vary by operation or model as noted below:

  • When using these operations, you can only include images and documents if the role is user.

  • Video generation: Video generation is not supported with InvokeModel and InvokeModelWithResponseStream. Instead, you can use the StartAsyncInvoke operation. For an example, see Use Amazon Nova Reel to generate a video from a text prompt.

  • Document support in request body: Including documents in the request body is not supported when using InvokeModel and InvokeModelWithResponseStream. To include a document during inference, use the Chat/text playground in the AWS Management Console or use the Converse or ConverseStream operations.

  • Document count and size: You can include up to 5 documents per request. Each document can be no more than 4.5 MB in size. For Claude 4 and subsequent versions, the 4.5 MB document size restriction doesn't apply to PDF format. For Nova models, the 4.5 MB document size restriction doesn't apply to PDF and DOCX formats. These restrictions continue to apply in the Bedrock Console. Individual models may have additional content restrictions beyond those applied by Amazon Bedrock. For more information, see Third-party model provider requirements.

  • Image count and size: Amazon Bedrock doesn't impose restrictions on image count and size. However, individual models may have specific image requirements. For more information, see Third-party model provider requirements.

  • Third-party model provider requirements: Third-party model provider requirements apply when you use InvokeModel, InvokeModelWithResponseStream, Converse, and ConverseStream operations, and may result in an error if not met. If you use a third-party model through Amazon Bedrock (for example, Anthropic Claude), review the provider's user guide and API documentation to avoid unexpected errors. For example, the Anthropic Messages standard endpoint supports a maximum request size of 32 MB. Claude also has specific content requirements, such as a maximum of 100 PDF pages per request and a maximum image size of 8000x8000 px. For the latest information about Anthropic Claude Messages requests and responses, including request size and content requirements, see the following Anthropic Claude documentation: Anthropic Claude API Overview, Anthropic Claude Messages API Reference, Build with Claude: Vision and Build with Claude: PDF Support.

Tip

Claude requires PDF documents to be a maximum of 100 pages per request. If you have larger PDF documents, we recommend splitting them into multiple PDFs under 100 pages each or consolidating more text into fewer pages.