模型能力

Multi-Image Editing

单次图像编辑最多可以使用三张源图像。你可以按图像在请求中的发送顺序指定它们。默认情况下,输出 aspect ratio 跟随第一张输入图像。你可以通过将aspect_ratio参数设置为特定比例来覆盖此行为,例如"1:1""16:9"

每张源图像都可以是公开 URL、base64 编码的 data URI,或来自file_idFiles API;也可以在单个请求中混用这些类型。有关Imagine → Files API Integrationfile_id的详情和示例,请参阅该文档。

点击选择
合并男性与幼犬的结果合并男性与女性的结果合并幼犬与女性的结果合并男性、幼犬与女性的结果
import xai_sdk

client = xai_sdk.Client()

response = client.image.sample(
    prompt="Show all subjects sitting together on the grass in a sunny park. Casual relaxed mood, natural daylight, warm tones. No additional people or animals.",
    model="grok-imagine-image-quality",
    image_urls=[
        "https://docs.x.ai/assets/api-examples/images/image-merge/woman.jpg",
        "https://docs.x.ai/assets/api-examples/images/image-merge/man.jpg",
        # "<image_url>",
    ],
    aspect_ratio="3:2",
)

print(response.url)