비디오 생성 액세스 및 사용

Amazon Nova Reel을 사용하여 비디오를 생성하는 것은 비동기 프로세스로, 일반적으로 6초 비디오의 경우 약 90초, 2분 비디오의 경우 약 14~17분이 소요됩니다. 비디오 생성을 시작하면 비디오가 사용자 계정의 Amazon S3 버킷에 작성됩니다. Amazon Bedrock은 사용자를 대신하여 Amazon S3 버킷에 파일을 작성하기 때문에 사용하는 AWS 역할에는 적절한 Amazon Bedrock 및 Amazon S3 작업과 s3:PutObject 작업을 허용하도록 구성된 권한이 필요합니다. 다음은 비디오를 생성하는 데 필요한 최소 작업 권한입니다.

하지만 비디오 생성 작업의 상태를 추적할 수 있도록 다음과 같은 추가 작업이 권장됩니다.

비디오 생성이 완료되면 비디오와 해당 구성 요소 샷이 지정된 Amazon S3 버킷에 저장됩니다. Amazon Nova는 각 간접 호출 ID에 대한 폴더를 생성합니다. 이 폴더에는 비디오 생성 요청으로 생성된 manifest.json, output.mp4 및 generation-status.json 파일이 있습니다.

비디오 생성 작업 시작

비디오 생성을 시작하려면 start_async_invoke()를 직접적으로 호출합니다. 그러면 새 간접 호출 작업이 생성됩니다. 작업이 완료되면 Amazon Nova는 생성된 비디오를 사용자가 지정하는 Amazon S3 버킷에 자동으로 저장합니다.

start_async_invoke()는 다음 인수를 사용합니다.

비디오 생성 입력 파라미터

Amazon Nova Reel을 사용하여 비디오를 생성하는 방법에 대한 자세한 내용은 다음 파라미터 설명을 참조하세요.

Text-to-video generation

다음 구조는 Amazon Nova Reel에 대한 비디오 생성 작업을 정의합니다.

{
    "taskType": "TEXT_VIDEO",
    "textToVideoParams": {
        "text": string,
        "images": ImageSource[] (list containing a single ImageSource)
    },
    "videoGenerationConfig": {
        "durationSeconds": int,
        "fps": int,
        "dimension": string, 
        "seed": int
    }
}

이러한 입력 파라미터는 비디오 생성 작업을 생성하는 데 필요합니다.

• text(필수) - 비디오를 생성하기 위한 텍스트 프롬프트입니다. 1~512자 길이여야 합니다.

• images(선택 사항) - 출력 비디오의 시작 키프레임으로 사용되는 단일 JPEG 또는 PNG 이미지입니다. 이 입력 이미지는 텍스트 프롬프트와 함께 비디오를 생성하는 데 사용됩니다. 이미지는 base64 문자열 형식이거나 Amazon S3 버킷에 저장되어야 합니다.

  이미지는 PNG 또는 JPEG 형식이어야 하며 색상 채널당 8비트(RGB)여야 합니다. PNG 이미지에는 추가 알파 채널이 포함될 수 있지만 해당 채널에 투명 또는 반투명 픽셀이 포함되지 않아야 합니다. 현재 모델은 1280(너비) x 720(높이)의 이미지만 허용합니다.

  Amazon S3 버킷을 통해 포함된 이미지는 25MB를 초과할 수 없습니다.

• durationSeconds(필수) - 출력 비디오의 기간입니다. 현재 지원되는 값은 6뿐입니다.

• fps(필수) - 출력 비디오의 프레임 속도입니다. 현재 지원되는 값은 24뿐입니다.

• dimension(필수) - 출력 비디오의 너비 및 높이입니다. ‘1280x720’이 현재 지원되는 유일한 값입니다.

• seed(선택 사항) - 생성 프로세스의 초기 노이즈 설정을 결정합니다. 다른 모든 파라미터를 동일하게 유지하면서 시드 값을 변경하면 프롬프트, 치수 및 기타 설정을 여전히 준수하는 완전히 새로운 비디오가 생성됩니다. 완벽한 이미지를 찾기 위해 다양한 시드 값으로 실험하는 것이 일반적입니다.

  시드 값은 0~2,147,483,646이어야 하며 기본값은 42입니다.

imageSource 스키마

이미지를 입력으로 사용하는 경우 다음 구조를 사용하여 요청에 이미지를 포함합니다.

{
    "format": "png" | "jpeg"
    "source": {
        "bytes": string (base64 encoded image)
    }
}

• format(필수) - 입력 이미지의 형식과 일치해야 합니다. ‘png‘ 또는 ‘jpeg‘입니다.

• source(필수)

  • bytes(필수) - base64 문자열로 인코딩된 입력 이미지입니다. 이미지의 해상도는 1280 x 720이어야 합니다.

Automated long video generation

MULTI_SHOT_AUTOMATED 태스크를 사용하여 텍스트 프롬프트만 사용하여 최대 2분 길이의 비디오를 6초 단위로 생성할 수 있습니다. 최대 4,000자의 텍스트 프롬프트를 제공할 수 있지만 입력 이미지는 제공할 수 없습니다.

{
    "taskType": "MULTI_SHOT_AUTOMATED",
    "multiShotAutomatedParams": {
        "text": string,
    },
    "videoGenerationConfig": {
        "durationSeconds": int,
        "fps": int,
        "dimension": string, 
        "seed": int
    }
}

이러한 입력 파라미터는 비디오 생성 작업을 생성하는 데 필요합니다.

• text(필수) - 비디오를 생성하기 위한 텍스트 프롬프트입니다. 1~4,000자 길이여야 합니다.

• durationSeconds(필수) - 출력 비디오의 길이입니다. 6의 배수(12~120)입니다.

• fps(필수) - 출력 비디오의 프레임 속도입니다. 현재 지원되는 값은 24뿐입니다.

• dimension(필수) - 출력 비디오의 너비 및 높이입니다. ‘1280x720’이 현재 지원되는 유일한 값입니다.

• seed(선택 사항) - 생성 프로세스의 초기 노이즈 설정을 결정합니다. 다른 모든 파라미터를 동일하게 유지하면서 시드 값을 변경하면 프롬프트, 치수 및 기타 설정을 여전히 준수하는 완전히 새로운 이미지가 생성됩니다. 완벽한 이미지를 찾기 위해 다양한 시드 값으로 실험하는 것이 일반적입니다.

  시드 값은 0~2, 147, 483, 646 사이여야 하며 기본값은 42입니다.

Manual long video generation

MULTI_SHOT_MANUAL 태스크를 사용하여 여러 텍스트 프롬프트와 입력 이미지로 최대 2분 길이의 비디오를 생성할 수 있습니다. 비디오의 6초 샷에 대해 선택적 입력 이미지와 함께 텍스트 프롬프트를 제공할 수 있습니다. 비디오 길이는 지정하는 샷 수에 따라 결정됩니다.

model_input = {
  "taskType": "MULTI_SHOT_MANUAL",
  "multiShotManualParams": {
    "shots": [
      {
        "text": "Information for shot 1"
      },
      {
        "text": "Information for shot 2",
        "image": {
          "format": "png", # Must be "png" or "jpeg"
          "source": {
            "bytes": "<base64 image string>"
          },
        },
      },
      {
        "text": "Information for shot 3",
        "image": {
            "format": "png",  # Must be "png" or "jpeg"
            "source": {
                "s3Location": {
                    "uri": "<S3 URI string>",
                    "bucketOwner": "<S3 bucket owner string>" # Optional
                }
            }
        }
      },
    ]
  },
  "videoGenerationConfig": {
        "fps": int,
        "dimension": string, 
        "seed": int
    }
}

이러한 입력 파라미터는 비디오 생성 작업을 생성하는 데 필요합니다.

• shots(필수) - 비디오 생성에 사용되는 텍스트 프롬프트와 입력 이미지에 대한 정보를 포함합니다.

• text(필수) - 비디오를 생성하기 위한 텍스트 프롬프트입니다. 1~512자 길이여야 합니다.

• image(선택 사항) -이 샷에 사용되는 입력 이미지에 대한 정보를 포함합니다. 이미지는 bytes 필드에 base64 문자열로 제공되거나 s3Location 필드에 Amazon S3 URI로 제공될 수 있습니다.

  이미지는 PNG 또는 JPEG 형식이어야 하며 색상 채널당 8비트(RGB)여야 합니다. PNG 이미지에는 추가 알파 채널이 포함될 수 있지만 해당 채널에 투명 또는 반투명 픽셀이 포함되지 않아야 합니다. 현재 모델은 1280(너비) x 720(높이)의 이미지만 허용합니다.

  Amazon S3 버킷을 통해 포함된 이미지는 25MB를 초과할 수 없습니다.

• fps(필수) - 출력 비디오의 프레임 속도입니다. 현재 지원되는 값은 24뿐입니다.

• dimension(필수) - 출력 비디오의 너비 및 높이입니다. ‘1280x720’이 현재 지원되는 유일한 값입니다.

• seed(선택 사항) - 생성 프로세스의 초기 노이즈 설정을 결정합니다. 다른 모든 파라미터를 동일하게 유지하면서 시드 값을 변경하면 프롬프트, 치수 및 기타 설정을 여전히 준수하는 완전히 새로운 이미지가 생성됩니다. 완벽한 이미지를 찾기 위해 다양한 시드 값으로 실험하는 것이 일반적입니다.

  시드 값은 0~2, 147, 483, 646 사이여야 하며 기본값은 42입니다.

비디오 생성 프로세스를 수행하면 지정된 Amazon S3 대상에 다음 파일이 작성됩니다.

비디오 생성 작업의 진행 상황 확인

비디오 생성 작업의 진행 상황을 확인하는 방법에는 두 가지가 있습니다. 간접 호출을 시작할 때 반환된 간접 호출 ARN에 대한 참조가 있는 경우 Amazon Bedrock 런타임의 get_async_invoke() 메서드를 사용할 수 있습니다.

response = bedrock_runtime.get_async_invoke(
    invocationArn="arn:AWS:bedrock:us-east-1:account-id:async-invoke/invocation-id"
)

status = response["status"]
print(f"Status: {status}")

작업 상태는 ‘완료됨‘, ‘진행 중‘ 또는 ‘실패‘가 됩니다. get_async_invoke() 메서드 사용에 대한 자세한 내용은 Async Invoke API 설명서를 참조하세요.

간접 호출 ARN에 대한 참조가 없거나 여러 작업의 상태를 한 번에 확인하려는 경우 Amazon Bedrock 런타임의 list_async_invokes() 메서드를 사용할 수 있습니다.

invocations_details = bedrock_runtime.list_async_invokes(
    maxResults=10,  # (Optional)
    statusEquals="InProgress",  # (Optional) Can be "Completed", "InProgress", or "Failed". Omit this argument to list all jobs, regardless of status.
    # Note: There are other supported arguments not demonstrated here.
)

print(json.dumps(invocations_details, indent=2, default=str))

list_async_invokes() 메서드 사용에 대한 자세한 내용은 Async Invoke API 설명서를 참조하세요.

비디오 생성 작업의 결과에 액세스

비디오 생성 작업이 성공하거나 실패한 후 Amazon S3 버킷에 JSON 파일이 추가됩니다. 이 파일에는 비디오용으로 생성된 샷에 대한 메타데이터가 들어 있습니다. 이 파일의 이름은 video-generation-status.json입니다.

성공적인 비디오 생성 요청을 위해 파일에는 전체 비디오를 구성하는 각 개별 샷의 위치가 들어 있습니다. 실패한 요청의 경우 파일에 실패 메시지와 샷이 실패한 이유에 대한 추가 세부 정보가 들어 있습니다.

이 JSON 파일의 스키마는 아래와 같습니다.

{
    "schemaVersion": string,
    "shots": [{
            "status": enum, // where success is generation + upload
            "location": string,
            "failureType": enum,
            "failureMessage": string,
        },
        ...
    ],
    "fullVideo": {
        "status": enum, // where success is generation + upload
        "location": string,
        "failureType": enum,
        "failureMessage": string,
    }
}

가능한 실패 이유와 메시지는 다음과 같습니다.