模型能力
Multi-Image Editing
单次图像编辑最多可以使用三张源图像。你可以按图像在请求中的发送顺序指定它们。默认情况下,输出 aspect ratio 跟随第一张输入图像。你可以通过将aspect_ratio参数设置为特定比例来覆盖此行为,例如"1:1"或"16:9"。
每张源图像都可以是公开 URL、base64 编码的 data URI,或来自file_id的Files API;也可以在单个请求中混用这些类型。有关Imagine → Files API Integration中file_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)相关内容
Image Generation,根据文本 prompt 生成图像
Image Editing,使用自然语言编辑源图像
API Reference,完整的 endpoint 文档
Imagine API Landing Page,查看 Imagine API 的实际效果