Imagine API 让你使用 Grok Imagine 模型生成和编辑图像与视频。它支持图像生成、最多使用 5 张参考图像的图像编辑、根据文本或静态图像生成视频、视频编辑等功能。

图像编辑

使用自然语言编辑图像。每次请求最多支持 3 张参考图像。

价格: $0.05 / image
分辨率: 1K & 2K

阅读文档在 Playground 中试用

视频生成

根据文本或图像参考创建视频，并支持预设语音，最高可达 1080p。

价格: $0.08 / sec
分辨率: 480p、720p 和 1080p

阅读文档在 Playground 中试用

图像生成

根据文本 prompt 生成图像，并可配置宽高比、分辨率、质量和数量。

价格: $0.04 / image
分辨率: 1K & 2K

阅读文档在 Playground 中试用

定价

图像生成采用按图固定计价，与提示词长度无关。每张生成的图像都会收取固定费用。图像编辑会同时对输入图像和生成的输出图像计费。视频生成按秒计费，时长和分辨率都会影响总成本。完整定价详情请参阅定价页面。

图像生成

使用 Grok Imagine 模型根据文本提示词生成新图像。你可以配置输出数量（每次请求最多 10 张图像）、宽高比、分辨率和响应格式。

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

const { image } = await generateImage({
    model: xai.image("grok-imagine-image-2.0"),
    prompt: "A collage of London landmarks in a stenciled street‑art style",
});

console.log(image.base64);

from openai import OpenAI

client = OpenAI(
    base_url="https://api.x.ai/v1",
    api_key="YOUR_API_KEY",
)

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

print(response.data[0].url)

curl -X POST https://api.x.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A collage of London landmarks in a stenciled street‑art style"
  }'

import xai_sdk

client = xai_sdk.Client()

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)

图像编辑

用自然语言编辑源图像。提供公开图像 URL 或 base64 编码的 data URI，再描述希望 Grok Imagine 应用的修改。多图编辑支持在单次请求中使用最多 5 张源图像，用于合并主体、迁移风格和构建场景。

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-2.0"),
    prompt: {
        text: "Render this as a pencil sketch with detailed shading",
        images: [`data:image/png;base64,${base64Image}`],
    },
});

console.log(image.base64);

# 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-2.0",
    "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"
    }
  }'

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-2.0",
    image_url=f"data:image/png;base64,{image_data}",
)

print(response.url)

视频生成

使用文本提示词让静态图像动起来。源图像会成为生成视频的起始画面。视频请求是异步的：发起请求，使用返回的请求 ID 轮询，并在完成后使用视频 URL。xAI SDK 和 AI SDK 会替你处理轮询。

import { xai } from "@ai-sdk/xai";
import { experimental_generateVideo as generateVideo } from "ai";

const result = await generateVideo({
    model: xai.video("grok-imagine-video-1.5"),
    prompt: {
        image: "https://docs.x.ai/assets/api-examples/video/waterfall-still.png",
        text: "Make the water crash down and slowly pan out the camera",
    },
    duration: 12,
});

const videoUrl = result.providerMetadata?.xai?.videoUrl;
console.log(videoUrl);

# Start the video generation request
REQUEST_ID=$(curl -s -X POST https://api.x.ai/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Make the water crash down and slowly pan out the camera",
    "image": {"url": "https://docs.x.ai/assets/api-examples/video/waterfall-still.png"},
    "duration": 12
  }' | jq -r '.request_id')

# Poll until the video is ready
while true; do
  RESULT=$(curl -s https://api.x.ai/v1/videos/$REQUEST_ID \
    -H "Authorization: Bearer $XAI_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  if [ "$STATUS" = "done" ]; then
    echo "$RESULT" | jq -r '.video.url'
    break
  elif [ "$STATUS" = "failed" ] || [ "$STATUS" = "expired" ]; then
    echo "Request $STATUS"; echo "$RESULT" | jq .
    break
  fi
  sleep 5
done

import os
import xai_sdk

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

response = client.video.generate(
    prompt="Make the water crash down and slowly pan out the camera",
    model="grok-imagine-video-1.5",
    image_url="https://docs.x.ai/assets/api-examples/video/waterfall-still.png",
    duration=12,
)

print(response.url)

企业合规与安全

Imagine API 面向具有严格安全与合规要求的生产工作负载构建。生成的媒体会接受内容政策审查，且不会用于训练。

SOC 2 Type II — 针对安全性、可用性和保密性实施经审计的控制措施
符合 HIPAA 资格 — 可为处理 PHI 的医疗健康应用提供 BAA
符合 GDPR — 提供数据处理协议和 EU 数据驻留选项
数据驻留 — 根据合规要求进行区域化处理
高可用性 — 为企业工作负载提供多区域基础设施和定制 SLA
SSO 与 RBAC — 支持 SAML SSO、基于角色的访问控制和审计日志

最后更新：2026 年 10 月 8 日

从写代码，到创作下一幕

Agent Plan & Coding Plan

Seedance 2.5

模型能力

Imagine 概览

图像编辑

视频生成

图像生成

定价

图像生成

图像编辑

视频生成

更多能力

企业合规与安全