模型能力

图像编辑

通过提供源图像和您的提示来编辑现有图像。模型理解图像内容并应用您请求的更改。

WARNING

OpenAI SDK 的 images.edit() 方法不支持图像编辑，因为它使用 multipart/form-data，而 xAI API 需要 application/json。请改用 xAI SDK、Vercel AI SDK 或直接的 HTTP 请求。

使用 xAI SDK 时，使用相同的 sample() 方法；只需添加 image_url 参数：

python

import base64
import xai_sdk

client = xai_sdk.Client()

# Load image from file and encode as base64
with open("photo.png", "rb") as f:
    image_data = base64.b64encode(f.read()).decode("utf-8")

response = client.image.sample(
    prompt="Render this as a pencil sketch with detailed shading",
    model="grok-imagine-image-quality",
    image_url=f"data:image/png;base64,{image_data}",
)

print(response.url)

bash

# Using a public URL as the source image
curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "Render this as a pencil sketch with detailed shading",
    "image": {
      "url": "https://docs.x.ai/assets/api-examples/images/style-realistic.png",
      "type": "image_url"
    }
  }'

javascript

import { xai } from "@ai-sdk/xai";
import { generateImage } from "ai";
import fs from "fs";

// Load image and encode as base64
const imageBuffer = fs.readFileSync("photo.png");
const base64Image = imageBuffer.toString("base64");

const { image } = await generateImage({
    model: xai.image("grok-imagine-image-quality"),
    prompt: {
        text: "Render this as a pencil sketch with detailed shading",
        images: [`data:image/png;base64,${base64Image}`],
    },
});

console.log(image.base64);

您可以通过以下方式提供源图像：

指向图像的公共 URL
base64 编码的数据 URI（例如，data:image/jpeg;base64,...）
来自 Files API 的 file_id — 请参阅 Imagine → Files API 集成

多轮编辑

通过将每个输出作为下一个输入来链接多个编辑。这实现了迭代优化；从基础图像开始，逐步添加细节、调整样式或进行修正。

风格转换

grok-imagine-image-quality 模型支持广泛的视觉风格，从超写实摄影到动漫、油画和铅笔素描。通过在提示中描述所需的美学效果来转换现有图像。

模型能力 ​

图像编辑 ​

多轮编辑 ​

风格转换 ​

相关 ​

模型能力

图像编辑

多轮编辑

风格转换

相关