推理 API

图像

查看 Markdown

图像生成

/v1/images/generations

根据 prompt 生成图像。这是向图像生成模型发起生成请求的 API endpoint。

请求体

响应体

dataarray<object>

(array<object>,必填)— 生成的图像对象列表。

代码示例

**响应示例:**


Example
curl -s 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"
  }'
Exampletext

text

{
  "data": [
    {
      "url": "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-a73bae6f-5a65-4bec-9ffb-8220caa3fa61.jpeg",
      "mime_type": "image/jpeg",
      "revised_prompt": ""
    }
  ],
  "usage": {
    "cost_in_usd_ticks": 200000000
  }
}

图像编辑

/v1/images/edits

根据 prompt 编辑图像。这是向图像生成模型发起编辑请求的 API endpoint。

请求体

promptstring

(string,必填):用于图像编辑的 prompt。

响应体

dataarray<object>

(array<object>,必填)— 生成的图像对象列表。

代码示例

**响应示例:**

Example
curl -s 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"
    }
  }'
Exampletext

text

{
  "data": [
    {
      "url": "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-82f06097-a9ad-4db4-9c8d-8197c74eebd1.jpeg",
      "mime_type": "image/jpeg",
      "revised_prompt": ""
    }
  ],
  "usage": {
    "cost_in_usd_ticks": 220000000
  }
}

最后更新:2026 年 4 月 13 日