전체 임베딩 요청 및 응답 스키마

전체 동기식 스키마

{
    "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"
        }
    }
}

   

다음 목록에는 요청에 대한 모든 파라미터가 포함되어 있습니다.

InvokeModel 응답 본문

InvokeModel이 성공적인 결과를 반환할 경우 응답 본문의 구조는 다음과 같습니다.

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

다음 목록에는 요청에 대한 모든 파라미터가 포함되어 있습니다.

전체 비동기식 스키마

Amazon Bedrock 런타임 API 함수 StartAsyncInvoke, GetAsyncInvoke 및 ListAsyncInvokes를 사용하여 비동기식으로 임베딩을 생성할 수 있습니다. 긴 텍스트 구절이나 30초가 넘는 비디오 또는 오디오와 같은 긴 콘텐츠를 분할하기 위해 Nova Embeddings를 사용하려면 비동기식 API를 사용해야 합니다.

StartAsyncInvoke를 직접적으로 호출할 때 modelId, outputDataConfig 및 modelInput 파라미터를 제공해야 합니다.

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

outputDataConfig는 생성된 출력을 저장할 S3 버킷을 지정합니다. 이 변수의 구조는 다음과 같습니다.

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

s3Uri는 대상 버킷의 S3 URI입니다. 추가 선택적 파라미터는 StartAsyncInvoke 설명서를 참조하세요.

modelInput 파라미터에는 다음 구조가 사용됩니다.

{
    "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
            }
        }
    }
}
  

다음 목록에는 요청에 대한 모든 파라미터가 포함되어 있습니다.

StartAsyncInvoke 응답

StartAsyncInvoke 직접 호출의 응답 구조는 아래와 같습니다. invocationArn은 GetAsyncInvoke 함수를 사용하여 비동기식 작업의 상태를 쿼리하는 데 사용할 수 있습니다.

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

비동기식 출력

비동기식 임베딩 생성이 완료되면 출력 대상으로 지정한 S3 버킷에 출력 아티팩트가 작성됩니다. 파일 구조는 다음과 같습니다.

   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.json에는 전체 작업 결과와 양식당 실제 임베딩을 포함하는 해당 jsonl 파일에 대한 참조가 포함됩니다. 다음은 잘린 파일의 예입니다.

{
    "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.json은 각 양식에 대한의 임베딩 출력을 포함하는 jsonl 파일입니다. jsonl 파일의 각 줄은 다음 스키마를 따릅니다.

{
    "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
}
  

다음 목록에는 응답에 대한 모든 파라미터가 포함되어 있습니다. 텍스트 문자 또는 오디오/비디오 시간의 경우 모든 시작 시간과 종료 시간은 0을 기준으로 합니다. 또한 모든 종료 텍스트 위치 또는 오디오/비디오 시간 값은 포괄적입니다.

Nova Embeddings에 대한 파일 제한 사항

동기식 작업은 S3 입력과 인라인 청크 모두 수락할 수 있습니다. 비동기식 작업은 S3 입력만 수락할 수 있습니다.

비동기식으로 임베딩을 생성할 때 파일이 적절한 수의 세그먼트로 분리되어 있는지 확인해야 합니다. 텍스트 임베딩의 경우 세그먼트는 1,900개를 초과할 수 없습니다. 오디오 및 비디오 임베딩의 경우 세그먼트는 1,434개를 초과할 수 없습니다.