本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Stable Image Ultra 请求和响应
请求正文在InvokeModel操作请求body字段中传递。
模型调用请求正文字段
使用 Stable Image Ultra 模型拨 InvokeModel 打电话时，在正文字段中填入如下所示的 JSON 对象。
模型调用响应正文字段
当你使用 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
-
St Stability.ai able Image Ultra 模型具有以下用于文本到图像推理调用的推理参数。
可选字段
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。
-
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
-
St Stability.ai able Image Ultra 模型具有以下用于图像到图像推理调用的推理参数。
可选字段
image –（字符串）用作生成起点的 Base64 图像。支持的格式：JPEG、PNG、WebP。
strength –（数字）image 参数对生成的图像的影响程度。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")
