xai_api.Image

用于调用图像生成模型的 API 服务。

方法：xai_api.Image

GenerateImageunary

根据文本 prompt 创建图像，也可以选择提供另一张图像。

生成图像

import os
import xai_sdk

client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))

response = client.image.sample(
    prompt="A collage of London landmarks in a stenciled street-art style",
    model="grok-imagine-image-2.0",
)

print(response.url)

buf curl --schema . --protocol grpc \
  -H "Authorization: Bearer $XAI_API_KEY" \
  --data '{
    "prompt": "A collage of London landmarks in a stenciled street-art style",
    "model": "grok-imagine-image-2.0",
    "format": "IMG_FORMAT_URL"
  }' \
  https://api.x.ai/xai_api.Image/GenerateImage

编辑图像

import os
import xai_sdk

client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))

response = client.image.sample(
    prompt="Render this as a pencil sketch with detailed shading",
    model="grok-imagine-image-2.0",
    image_url="https://docs.x.ai/assets/api-examples/images/style-realistic.png",
)

print(response.url)

buf curl --schema . --protocol grpc \
  -H "Authorization: Bearer $XAI_API_KEY" \
  --data '{
    "prompt": "Render this as a pencil sketch with detailed shading",
    "model": "grok-imagine-image-2.0",
    "image": {"image_url": "https://docs.x.ai/assets/api-examples/images/style-realistic.png", "detail": "DETAIL_AUTO"},
    "format": "IMG_FORMAT_URL"
  }' \
  https://api.x.ai/xai_api.Image/GenerateImage

最后更新：2026 年 9 月 2 日