编辑图像

POST

/v1/images/edits

最后修改时间：2026-07-10 05:44:43

根据文本提示生成图像

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Header 参数

Body 参数application/json

示例

{
    "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"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/images/edits' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "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"
    }
}'

返回响应

🟢200成功

application/json

成功生成图像

Bodyapplication/json

示例

{
    "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-07-10 05:44:43

生成图像

提交素材审核任务