Skip to main content
POST
/
litellm
/
bedrock
/
model
/
{modelId}
/
converse
Converse with model (LiteLLM - Bedrock format)
curl --request POST \
  --url http://localhost:8080/litellm/bedrock/model/{modelId}/converse \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "text": "<string>",
          "image": {
            "format": "jpeg",
            "source": {
              "bytes": "aSDinaTvuI8gbWludGxpZnk="
            }
          },
          "document": {
            "format": "pdf",
            "name": "<string>",
            "source": {
              "bytes": "aSDinaTvuI8gbWludGxpZnk=",
              "text": "<string>"
            }
          },
          "toolUse": {
            "toolUseId": "<string>",
            "name": "<string>",
            "input": {}
          },
          "toolResult": {
            "toolUseId": "<string>",
            "content": [
              {
                "text": "<string>",
                "image": {
                  "format": "jpeg",
                  "source": {
                    "bytes": "aSDinaTvuI8gbWludGxpZnk="
                  }
                },
                "document": {
                  "format": "pdf",
                  "name": "<string>",
                  "source": {
                    "bytes": "aSDinaTvuI8gbWludGxpZnk=",
                    "text": "<string>"
                  }
                },
                "toolUse": {
                  "toolUseId": "<string>",
                  "name": "<string>",
                  "input": {}
                },
                "toolResult": "<unknown>",
                "guardContent": {
                  "text": {
                    "text": "<string>",
                    "qualifiers": [
                      "<string>"
                    ]
                  }
                },
                "reasoningContent": {
                  "reasoningText": {
                    "text": "<string>",
                    "signature": "<string>"
                  }
                },
                "json": {},
                "cachePoint": {
                  "type": "default"
                }
              }
            ],
            "status": "success"
          },
          "guardContent": {
            "text": {
              "text": "<string>",
              "qualifiers": [
                "<string>"
              ]
            }
          },
          "reasoningContent": {
            "reasoningText": {
              "text": "<string>",
              "signature": "<string>"
            }
          },
          "json": {},
          "cachePoint": {
            "type": "default"
          }
        }
      ]
    }
  ],
  "system": [
    {
      "text": "<string>",
      "guardContent": {
        "text": {
          "text": "<string>",
          "qualifiers": [
            "<string>"
          ]
        }
      },
      "cachePoint": {
        "type": "default"
      }
    }
  ],
  "inferenceConfig": {
    "maxTokens": 123,
    "temperature": 123,
    "topP": 123,
    "stopSequences": [
      "<string>"
    ]
  },
  "toolConfig": {
    "tools": [
      {
        "toolSpec": {
          "name": "<string>",
          "description": "<string>",
          "inputSchema": {
            "json": {}
          }
        },
        "cachePoint": {
          "type": "default"
        }
      }
    ],
    "toolChoice": {
      "auto": {},
      "any": {},
      "tool": {
        "name": "<string>"
      }
    }
  },
  "guardrailConfig": {
    "guardrailIdentifier": "<string>",
    "guardrailVersion": "<string>",
    "trace": "enabled"
  },
  "additionalModelRequestFields": {},
  "additionalModelResponseFieldPaths": [
    "<string>"
  ],
  "performanceConfig": {
    "latency": "standard"
  },
  "promptVariables": {},
  "requestMetadata": {},
  "serviceTier": {
    "type": "reserved"
  },
  "fallbacks": [
    "<string>"
  ]
}
'
{
  "output": {
    "message": {
      "role": "user",
      "content": [
        {
          "text": "<string>",
          "image": {
            "format": "jpeg",
            "source": {
              "bytes": "aSDinaTvuI8gbWludGxpZnk="
            }
          },
          "document": {
            "format": "pdf",
            "name": "<string>",
            "source": {
              "bytes": "aSDinaTvuI8gbWludGxpZnk=",
              "text": "<string>"
            }
          },
          "toolUse": {
            "toolUseId": "<string>",
            "name": "<string>",
            "input": {}
          },
          "toolResult": {
            "toolUseId": "<string>",
            "content": [
              {
                "text": "<string>",
                "image": {
                  "format": "jpeg",
                  "source": {
                    "bytes": "aSDinaTvuI8gbWludGxpZnk="
                  }
                },
                "document": {
                  "format": "pdf",
                  "name": "<string>",
                  "source": {
                    "bytes": "aSDinaTvuI8gbWludGxpZnk=",
                    "text": "<string>"
                  }
                },
                "toolUse": {
                  "toolUseId": "<string>",
                  "name": "<string>",
                  "input": {}
                },
                "toolResult": "<unknown>",
                "guardContent": {
                  "text": {
                    "text": "<string>",
                    "qualifiers": [
                      "<string>"
                    ]
                  }
                },
                "reasoningContent": {
                  "reasoningText": {
                    "text": "<string>",
                    "signature": "<string>"
                  }
                },
                "json": {},
                "cachePoint": {
                  "type": "default"
                }
              }
            ],
            "status": "success"
          },
          "guardContent": {
            "text": {
              "text": "<string>",
              "qualifiers": [
                "<string>"
              ]
            }
          },
          "reasoningContent": {
            "reasoningText": {
              "text": "<string>",
              "signature": "<string>"
            }
          },
          "json": {},
          "cachePoint": {
            "type": "default"
          }
        }
      ]
    }
  },
  "stopReason": "end_turn",
  "usage": {
    "inputTokens": 123,
    "outputTokens": 123,
    "totalTokens": 123,
    "cacheReadInputTokens": 123,
    "cacheWriteInputTokens": 123
  },
  "metrics": {
    "latencyMs": 123
  },
  "additionalModelResponseFields": {},
  "trace": {},
  "performanceConfig": {
    "latency": "standard"
  },
  "serviceTier": {
    "type": "reserved"
  }
}

Path Parameters

modelId
string
required

Model ID

Body

application/json
messages
object[]

Array of messages for the conversation

system
object[]

System messages/prompts

inferenceConfig
object
toolConfig
object
guardrailConfig
object
additionalModelRequestFields
object

Model-specific parameters

additionalModelResponseFieldPaths
string[]
performanceConfig
object
promptVariables
object
requestMetadata
object
serviceTier
object
fallbacks
string[]

Response

Successful response

output
object
stopReason
enum<string>
Available options:
end_turn,
tool_use,
max_tokens,
stop_sequence,
guardrail_intervened,
content_filtered
usage
object
metrics
object
additionalModelResponseFields
object
trace
object
performanceConfig
object
serviceTier
object