JSON 图片编辑

请求使用 application/json，通过公网可访问的图片 URL 提交单图或多图编辑任务。

POST/v1/images/edits

根据文本指令编辑一张或多张参考图片。请求必须使用 application/json，并通过 image 或 images 传入公网可访问的图片 URL。

该 JSON URL 请求结构仅适用于支持 Grok 图片编辑的模型。

请使用 /v1/images/edits，不要使用 /v1/edits。多图参考请使用 images，不建议使用 reference_images。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Grok 图片编辑请求参数。image 和 images 至少提供一个。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

用于图片编辑的模型 ID。支持该请求格式的模型包括 grok-imagine-image 和 grok-imagine-image-pro；实际可用范围以当前 API Key 返回的模型列表和通道能力为准。

Length1 <= length

prompt*string

图片编辑指令。建议明确说明需要保留的主体、需要修改的区域和目标风格。

Length1 <= length

image?|

条件必填。单张输入图片，推荐传入服务端和模型上游均可访问的公网图片 URL；image 与 images 至少填写一个，不得同时省略。

images?array<>

条件必填。多张输入图片的公网 URL 列表；image 与 images 至少填写一个，不得同时省略。

Items1 <= items

size?string

图片尺寸或宽高比，例如 1024x1024、1:1 或 16:9。

n?integer

要生成的编辑结果数量。不传时通常按 1 张处理。

Range1 <= value

Default1

response_format?string

返回格式，由服务端和上游模型的实际能力决定。

Response Body

`application/json`

curl -X POST "https://example.com/v1/images/edits" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "把图片改成赛博朋克夜景风格，保留主体人物",    "image": "https://example.com/input.png",    "size": "1024x1024",    "n": 1  }'

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`