View a markdown version of this page

Stable Image Ultra 요청 및 응답 - Amazon Bedrock

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Stable Image Ultra 요청 및 응답

요청 본문은 InvokeModel 작업 요청의 body 필드에 전달됩니다.

모델 간접 호출 요청 본문 필드

Stable Image Ultra 모델을 사용하여 InvokeModel을 호출할 때 본문 필드를 다음과 같은 JSON 객체로 채웁니다.

  • prompt - (문자열) 출력 이미지에서 확인하려는 내용입니다. 요소, 색상 및 주제를 명확하게 정의하는 강력하고 설명적인 프롬프트를 사용하면 더 나은 결과를 얻을 수 있습니다.

    최소 최대

    0

    10,000

모델 간접 호출 응답 본문 필드

Stable Image Ultra 모델을 사용하여 InvokeModel 호출하는 경우 응답은 다음과 같습니다.

{ 'seeds': [2130420379], "finish_reasons":[null], "images":["..."] }

완료 이유가가 아닌 응답null은 다음과 같습니다.

{ "finish_reasons":["Filter reason: prompt"] }
  • seeds - (문자열) 모델의 이미지를 생성하는 데 사용되는 시드 목록입니다.

  • finish_reasons – 요청이 필터링되었는지 여부를 나타내는 열거형입니다. null은 요청이 성공했음을 나타냅니다. 현재 가능한 값: "Filter reason: prompt", "Filter reason: output image", "Filter reason: input image", "Inference error", null.

  • images - base64 문자열 형식으로 생성된 이미지 목록입니다.

자세한 내용은 https://platform.us.stability.ai/docs/api-reference#tag/v1generation 참조하십시오.

Text to image

Stability.ai Stable Image Ultra 모델에는 텍스트 투 이미지 추론 직접 호출을 생성하기 위한 다음의 추론 파라미터가 포함되어 있습니다.

  • prompt - (문자열) 출력 이미지에서 확인하려는 내용입니다. 요소, 색상 및 주제를 명확하게 정의하는 강력하고 설명적인 프롬프트를 사용하면 더 나은 결과를 얻을 수 있습니다.

    최소 최대

    0

    10,000

선택 필드

  • aspect_ratio – (문자열) 생성된 이미지의 종횡비를 제어합니다. 이 파라미터는 텍스트 투 이미지 요청에만 유효합니다. 기본값은 1:1입니다. 열거형: 16:9, 1:1, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16, 9:21.

  • mode - text-to-image로 설정합니다. 기본값: text-to-image. 열거형: text-to-image

  • output_format – 출력 이미지의 형식을 지정합니다. 지원되는 형식: JPEG, PNG. 지원되는 크기: 높이 640~1,536픽셀, 너비 640~1,536픽셀.

  • seed – (숫자) 생성의 '무작위성'을 안내하는 데 사용되는 특정 값입니다. (임의 시드를 사용하려면 이 파라미터를 생략하거나 0을 전달합니다.) 범위: 0~4294967295.

  • negative_prompt – 출력 이미지에서 보고 싶지 않은 항목의 키워드입니다. 최대: 10,000자.

import boto3 import json import base64 import io from PIL import Image bedrock = boto3.client('bedrock-runtime', region_name='us-west-2') response = bedrock.invoke_model( modelId='stability.sd3-ultra-v1:1', body=json.dumps({ 'prompt': 'A car made out of vegetables.' }) ) output_body = json.loads(response["body"].read().decode("utf-8")) base64_output_image = output_body["images"][0] image_data = base64.b64decode(base64_output_image) image = Image.open(io.BytesIO(image_data)) image.save("image.png")
Image to image

Stability.ai Stable Image Ultra 모델에는 image-to-image 추론 직접 호출을 생성하기 위한 다음의 추론 파라미터가 포함되어 있습니다.

  • prompt - (문자열) 출력 이미지에서 확인하려는 내용입니다. 요소, 색상 및 주제를 명확하게 정의하는 강력하고 설명적인 프롬프트를 사용하면 더 나은 결과를 얻을 수 있습니다.

    최소 최대

    0

    10,000

선택 필드

  • image – (문자열) 생성의 시작점으로 사용할 Base64 이미지입니다. 지원되는 형식: JPEG, PNG, WebP.

  • strength – (숫자) 이미지 파라미터가 생성된 이미지에 미치는 영향입니다. 강도 값이 낮은 이미지는 원본 이미지와 비슷합니다. 범위: 0.0~1.0. 기본값은 0.35입니다.

  • aspect_ratio – (문자열) 생성된 이미지의 종횡비를 제어합니다. 이 파라미터는 텍스트 투 이미지 요청에만 유효합니다. 기본값은 1:1입니다. 열거형: 16:9, 1:1, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16, 9:21.

  • output_format – 출력 이미지의 형식을 지정합니다. 지원되는 형식: JPEG, PNG. 지원되는 크기: 높이 640~1,536픽셀, 너비 640~1,536픽셀.

  • seed – (숫자) 생성의 '무작위성'을 안내하는 데 사용되는 특정 값입니다. (임의 시드를 사용하려면 이 파라미터를 생략하거나 0을 전달합니다.) 범위: 0~4294967295.

  • negative_prompt – 출력 이미지에서 보고 싶지 않은 항목의 키워드입니다. 최대: 10,000자.

import boto3 import json import base64 import io from PIL import Image bedrock = boto3.client('bedrock-runtime', region_name='us-west-2') response = bedrock.invoke_model( modelId='stability.sd3-ultra-v1:1', body=json.dumps({ 'prompt': 'A car made out of vegetables.' }) ) output_body = json.loads(response["body"].read().decode("utf-8")) base64_output_image = output_body["images"][0] image_data = base64.b64decode(base64_output_image) image = Image.open(io.BytesIO(image_data)) image.save("image.png")