推理 API
图像
图像生成
/v1/images/generations
根据 prompt 生成图像。这是向图像生成模型发起生成请求的 API endpoint。
请求体
响应体
dataarray<object>(array<object>,必填)— 生成的图像对象列表。
代码示例
**响应示例:**
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"
}'
{
"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>,必填)— 生成的图像对象列表。
代码示例
**响应示例:**
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"
}
}'
{
"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 日