基本生成
使用 grok-imagine-image-quality 模型生成高质量图像：
Python
import os
import xai_sdk
client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))
response = client.image.sample(
prompt="赛博朋克风格的 Tokyo 街道，霓虹灯闪烁",
model="grok-imagine-image-quality",
n=4, # 生成 4 张图像
)
for img in response:
print(img.url)模型选择
| 模型 | 特点 | 1K 分辨率 | 2K 分辨率 |
|---|---|---|---|
| grok-imagine-image-quality | 高质量模式，适合需要最佳质量的场景 | $0.05 / 张 | $0.07 / 张 |
| grok-imagine-image | 标准模式，速度更快，成本更低 | $0.02 / 张 | $0.02 / 张 |
批量生成
使用 n 参数一次生成多张图像。批量生成适用于 A/B 测试和创意探索。
图像编辑
Imagine API 支持图像编辑功能 — 你可以提供原始图像和编辑指令：
Python (OpenAI)
from openai import OpenAI
client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")
response = client.images.edit(
model="grok-imagine-image-quality",
image=open("input.png", "rb"),
prompt="将背景改为日落场景",
)
print(response.data[0].url)多图编辑
多图编辑功能允许你上传多张图像进行组合编辑。你可以指定不同的编辑指令， 模型会智能地融合多张图像的内容。
分辨率和宽高比
- 1K 分辨率 — 1024 x 1024 像素（默认）
- 2K 分辨率 — 2048 x 2048 像素（仅 quality 模型支持）
- 支持自定义宽高比 — 方形、横向、纵向
最佳实践
- 使用详细、具体的提示词获得更好的结果
- 指定风格、色调、构图等要素
- 对于生产用途，使用
grok-imagine-image-quality模型 - 对于快速原型和测试，使用
grok-imagine-image节省成本 - 批量生成时使用
n参数减少 API 调用次数