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.
El esquema de solicitud es prácticamente idéntico entre la API de Invoke (de transmisión y sin transmisión) y la API de Converse. Existen diferencias sutiles en relación con la codificación de la carga útil de imágenes y vídeos. Como Amazon Nova Micro no admite imágenes o vídeos como entrada, esas partes del esquema de solicitud no se aplican a Amazon Nova Micro. De lo contrario, el esquema de solicitud es el mismo para todos los modelos de comprensión de Amazon Nova.
{
"system": [
{
"text": string
}
],
"messages": [
{
"role": "user", //first turn should always be the user turn
"content": [
{
"text": string
},
{
"image": {
"format": "jpeg" | "png" | "gif" | "webp",
"source": {
"bytes": image // Binary array (Converse API) or Base64-encoded string (Invoke API)
}
}
},
{
"video": {
"format": "mkv" | "mov" | "mp4" | "webm" | "three_gp" | "flv" | "mpeg" | "mpg" | "wmv",
"source": {
// Option 1: Sending a S3 location
"s3Location": {
"uri": string, // example: s3://my-bucket/object-key
"bucketOwner": string // (Optional) example: "123456789012"
}
// Option 2: Sending file bytes
"bytes": video // Binary array (Converse API) or Base64-encoded string (Invoke API)
}
}
},
]
},
{
"role": "assistant",
"content": [
{
"text": string //prefilling assistant turn
}
]
}
],
"inferenceConfig":{ // all Optional, Invoke parameter names used in this example
"maxTokens": int, // greater than 0, equal or less than 5k (default: dynamic*)
"temperature": float, // greater then 0 and less than 1.0 (default: 0.7)
"topP": float, // greater than 0, equal or less than 1.0 (default: 0.9)
"topK": int, // 0 or greater (default: 50)
"stopSequences": [string]
},
"toolConfig": { // all Optional
"tools": [
{
"toolSpec": {
"name": string, //meaningful tool name (Max char: 64)
"description": string, //meaningful description of the tool
"inputSchema": {
"json": { // The JSON schema for the tool. For more information, see JSON Schema Reference
"type": "object",
"properties": {
args;: { //arguments
"type": string, //argument data type
"description": string //meaningful description
}
},
"required": [
string //args
]
}
}
}
}
],
"toolChoice": {"auto":{}} //Amazon Nova models ONLY support tool choice of "auto"
}
}Los siguientes son parámetros obligatorios:
-
system— (Opcional) El indicador del sistema para la solicitud.Un mensaje del sistema es una forma de proporcionar contexto e instrucciones a Amazon Nova, como especificar un objetivo o función en particular.
-
messages— (Obligatorio) Los mensajes de entrada.-
role— El papel del turno de conversación. Los valores válidos sonuseryassistant. -
content— (obligatorio) El contenido del turno de conversación.-
type— (obligatorio) El tipo de contenido. Los valores válidos sonimagetext, ovideo-
texto: contenido de texto
-
text- El contenido textual del turno de conversación.
-
-
imagen: contenido de la imagen (no aplicable a Amazon Nova Micro)
-
format— (obligatorio) El formato de la imagen. Puede especificar los siguientes formatos de imagen.-
jpeg -
png -
webp -
gif
-
-
source— (obligatorio) Los datos de la imagen. Para la API Invoke, debe ser una cadena de imagenbase64codificada. Para la API de Converse, debe ser una matriz de bytes. -
bytes— (obligatorio) Los datos de la imagen. Para la API Invoke, debe ser una cadena de imagen codificada en Base64. Para la API de Converse, debe ser una matriz de bytes.
-
-
vídeo: contenido de vídeo (no aplicable a Amazon Nova Micro)
-
format— (obligatorio) El formato de vídeo. Puede especificar los valores siguientes:-
mkv -
mov -
mp4 -
webm -
three_gp -
flv -
mpeg -
mpg -
wmv
-
-
source— (obligatorio) La fuente de los datos de vídeo. Puede especificar un URI de Amazon S3 o los bytes del archivo de vídeo en la solicitud.-
uri- (obligatorio) El URI de Amazon S3 del archivo de vídeo. Por ejemplo,“s3://my-bucket/object-key” -
bucketOwner— (opcional) El ID de cuenta propietario del bucket. Úselo si va a invocar el modelo desde una cuenta independiente. -
bytes— (obligatorio) Los datos de la imagen. Para la API Invoke, debe ser una cadena de imagen codificada en Base64. Para la API de Converse, debe ser una matriz de bytes.
-
-
-
-
-
-
inferenceConfig:Estos son valores de configuración de inferencia que se pueden pasar en la inferencia.-
maxTokens— (Opcional) El número máximo de fichas que se deben generar antes de parar.Tenga en cuenta que es posible que los modelos de Amazon Nova dejen de generar fichas antes de alcanzar el valor de
maxTokens. El valor máximo de fichas nuevas permitido es de 5000. -
temperature— (Opcional) La cantidad de aleatoriedad inyectada en la respuesta. Los valores válidos están entre 0,00001 y 1, ambos inclusive. El valor predeterminado es 0.7. -
topP— (Opcional) Utilice el muestreo de núcleos.Amazon Nova calcula la distribución acumulada entre todas las opciones de cada token subsiguiente en orden de probabilidad decreciente y la corta una vez que alcanza una probabilidad determinada especificada por
topP. Debe modificartemperatureotopP, pero no ambos. Los valores válidos están entre 0 y 1, ambos inclusive. El valor predeterminado es 0.9. -
topK— (Opcional) Muestre solo las K opciones principales para cada token subsiguiente.Utilice el
topKparámetro para eliminar las respuestas alargadas y de baja probabilidad. Los valores válidos están entre 0 y 128. El valor predeterminado es que no se utiliza este parámetro.nota
Al utilizar la API de Converse con el
topKparámetro, se debe incluir uninferenceConfigparámetro adicional en unadditionalModelRequestFieldscampo. Consulte un Uso de la API de Converse ejemplo de cómo se transfieren estos parámetros. -
stopSequences— (Opcional) Matriz de cadenas que contiene secuencias de paradas. Si el modelo genera alguna de esas cadenas, la generación se detendrá y se devolverá la respuesta hasta ese punto. -
toolConfig— (Opcional) objeto JSON siguiendo el ToolConfig esquema, que contiene la especificación de la herramienta y la elección de la herramienta. Este esquema es el mismo seguido por la API de Converse
-
