Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Permintaan penyematan lengkap dan skema respons

Skema sinkron lengkap

{
    "schemaVersion": "nova-multimodal-embed-v1",
    "taskType": "SINGLE_EMBEDDING",
    "singleEmbeddingParams": {
        "embeddingPurpose": "GENERIC_INDEX" | "GENERIC_RETRIEVAL" | "TEXT_RETRIEVAL" | "IMAGE_RETRIEVAL" | "VIDEO_RETRIEVAL" | "DOCUMENT_RETRIEVAL" | "AUDIO_RETRIEVAL" | "CLASSIFICATION" | "CLUSTERING",
        "embeddingDimension": 256 | 384 | 1024 | 3072,
        "text": {
            "truncationMode": "START" | "END" | "NONE",
            "value": string,
            "source": SourceObject,
        },
        "image": {
            "detailLevel": "STANDARD_IMAGE" | "DOCUMENT_IMAGE",
            "format": "png" | "jpeg" | "gif" | "webp",
            "source": SourceObject
        },
        "audio": {
            "format": "mp3" | "wav" | "ogg",
            "source": SourceObject
        },
        "video": {
            "format": "mp4" | "mov" | "mkv" | "webm" | "flv" | "mpeg" | "mpg" | "wmv" | "3gp",
            "source": SourceObject,
            "embeddingMode": "AUDIO_VIDEO_COMBINED" | "AUDIO_VIDEO_SEPARATE"
        }
    }
}

   

Daftar berikut mencakup semua parameter untuk permintaan:

InvokeModel Respon Tubuh

Ketika InvokeModelmengembalikan hasil yang sukses, tubuh respon akan memiliki struktur berikut:

{
   "embeddings": [
      {
          "embeddingType": "TEXT" | "IMAGE" | "VIDEO" | "AUDIO" | "AUDIO_VIDEO_COMBINED",
          "embedding": number[],
          "truncatedCharLength": int // Only included if text input was truncated
      }
    ]                       
}
   

Daftar berikut mencakup semua parameter untuk respons:

Skema asinkron lengkap

Anda dapat membuat penyematan secara asinkron menggunakan fungsi Amazon Bedrock Runtime API,, dan. StartAsyncInvokeGetAsyncInvokeListAsyncInvokes API asinkron harus digunakan jika Anda ingin menggunakan Nova Embeddings untuk menyegmentasikan konten panjang seperti teks atau video dan audio yang panjang lebih dari 30 detik.

Saat menelepon StartAsyncInvoke, Anda harus memberikanmodelId,outputDataConfig, dan modelInput parameter.

response = bedrock_runtime.start_async_invoke(
    modelId="amazon.nova-2-multimodal-embeddings-v1:0",
    outputDataConfig=Data Config,
    modelInput=Model Input
)
  

outputDataConfigmenentukan bucket S3 tempat Anda ingin menyimpan output yang dihasilkan. Ini memiliki struktur sebagai berikut:

{
    "s3OutputDataConfig": {
        "s3Uri": "s3://your-s3-bucket"
    }
} 
  

s3UriIni adalah URI S3 dari bucket tujuan. Untuk parameter opsional tambahan, lihat StartAsyncInvoke dokumentasi.

Struktur berikut digunakan untuk modelInput parameter.

{
    "schemaVersion": "nova-multimodal-embed-v1",
    "taskType": "SEGMENTED_EMBEDDING",
    "segmentedEmbeddingParams": {
        "embeddingPurpose": "GENERIC_INDEX" | "GENERIC_RETRIEVAL" | "TEXT_RETRIEVAL" | "IMAGE_RETRIEVAL" | "VIDEO_RETRIEVAL" | "DOCUMENT_RETRIEVAL" | "AUDIO_RETRIEVAL" | "CLASSIFICATION" | "CLUSTERING",
        "embeddingDimension": 256 | 384 | 1024 | 3072,
        "text": {
            "truncationMode": "START" | "END" | "NONE",
            "value": string,
            "source": {
                "s3Location": {
                    "uri": "s3://Your S3 Object"
                }
            },
            "segmentationConfig": {
                "maxLengthChars": int
            }
        },
        "image": {
            "format": "png" | "jpeg" | "gif" | "webp",
            "source": SourceObject,
            "detailLevel": "STANDARD_IMAGE" | "DOCUMENT_IMAGE"
        },
        "audio": {
            "format": "mp3" | "wav" | "ogg",
            "source": SourceObject,
            "segmentationConfig": {
                "durationSeconds": int
            }
        },
        "video": {
            "format": "mp4" | "mov" | "mkv" | "webm" | "flv" | "mpeg" | "mpg" | "wmv" | "3gp",
            "source": SourceObject,
            "embeddingMode": "AUDIO_VIDEO_COMBINED" | "AUDIO_VIDEO_SEPARATE",
            "segmentationConfig": {
                "durationSeconds": int
            }
        }
    }
}
  

Daftar berikut mencakup semua parameter untuk permintaan:

StartAsyncInvoke Respon

Tanggapan dari panggilan ke StartAsyncInvokeakan memiliki struktur di bawah ini. invocationArnDapat digunakan untuk menanyakan status pekerjaan asinkron menggunakan fungsi. GetAsyncInvoke

{
    "invocationArn": "arn:aws:bedrock:us-east-1:xxxxxxxxxxxx:async-invoke/lvmxrnjf5mo3",
}
  

Output Asinkron

Saat pembuatan embeddings asinkron selesai, artefak keluaran ditulis ke bucket S3 yang Anda tentukan sebagai tujuan keluaran. File-file tersebut akan memiliki struktur sebagai berikut:

   amzn-s3-demo-bucket/
    job-id/
        segmented-embedding-result.json
        embedding-audio.jsonl
        embedding-image.json
        embedding-text.jsonl
        embedding-video.jsonl
        manifest.json
  

segmented-embedding-result.jsonWill berisi hasil pekerjaan keseluruhan dan referensi ke file jsonl yang sesuai yang berisi penyematan aktual per modalitas. Di bawah ini adalah contoh file yang terpotong:

{
    "sourceFileUri": string, 
    "embeddingDimension": 256 | 384 | 1024 | 3072,
    "embeddingResults": [
        {
            "embeddingType": "TEXT" | "IMAGE" | "VIDEO" | "AUDIO" | "AUDIO_VIDEO_COMBINED",
            "status": "SUCCESS" | "FAILURE" | "PARTIAL_SUCCESS",
            "failureReason": string, // Granular error codes
            "message": string, // Human-readbale failure message
            "outputFileUri": string // S3 URI to a "embedding-modality.jsonl" file
        }
        ...
    ]
}
  

embedding-modality.jsonAkan menjadi file jsonl yang berisi output embedding untuk setiap modalitas. Setiap baris dalam file jsonl akan mematuhi skema berikut:

{
    "embedding": number[], // The generated embedding vector
    "segmentMetadata": {
        "segmentIndex": number,
        "segmentStartCharPosition": number, // Included for text only
        "segmentEndCharPosition": number, // Included for text only
        "truncatedCharLength": number, // Included only when text gets truncated
        "segmentStartSeconds": number, // Included for audio/video only
        "segmentEndSeconds": number // Included for audio/video only
    },
    "status": "SUCCESS" | "FAILURE",
    "failureReason": string, // Granular error codes
    "message": string // Human-readable failure message
}
  

Daftar berikut mencakup semua parameter untuk respons. Untuk karakter teks atau audio/video waktu, semua waktu mulai dan berakhir berbasis nol. Selain itu, semua posisi teks akhir atau nilai audio/video waktu bersifat inklusif.

Batasan file untuk Nova Embeddings

Operasi sinkron dapat menerima input S3 dan potongan sebaris. Operasi asinkron hanya dapat menerima input S3.

Saat membuat embeddings secara asinkron, Anda harus memastikan bahwa file Anda dipisahkan menjadi sejumlah segmen yang sesuai. Untuk penyematan teks Anda tidak dapat memiliki lebih dari 1900 segmen. Untuk penyematan audio dan video, Anda tidak dapat memiliki lebih dari 1434 segmen.