JSON 圖片編輯

請求使用 application/json，透過可公開存取的圖片 URL 提交單張或多張圖片編輯任務。

POST/v1/images/edits

根據文字指令編輯一張或多張參考圖片。請求必須使用 application/json，並透過 image 或 images 傳入可透過公開網路存取的圖片 URL。

此 JSON URL 請求結構僅適用於支援 Grok 圖片編輯的模型。

請使用 /v1/images/edits，不要使用 /v1/edits。多圖參考請使用 images，不建議使用 reference_images。

授權

bearerAuth

授權Bearer <token>

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

傳遞位置: header

請求主體

application/json

Grok 圖片編輯請求參數。image 和 images 至少提供一個。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

model*string

用於圖片編輯的模型 ID。支援此請求格式的模型包括 grok-imagine-image 和 grok-imagine-image-pro；實際可用範圍以目前 API Key 回傳的模型清單和供應管道能力為準。

長度1 <= length

prompt*string

圖片編輯指令。建議明確說明需要保留的主體、需要修改的區域和目標風格。

長度1 <= length

image?|

條件必填。單張輸入圖片，建議傳入伺服器端和模型上游均可存取的公開網路圖片 URL；image 與 images 至少填寫一個，不得同時省略。

images?array<>

條件必填。多張輸入圖片的公開網路 URL 清單；image 與 images 至少填寫一個，不得同時省略。

項目數1 <= items

size?string

圖片尺寸或長寬比，例如 1024x1024、1:1 或 16:9。

n?integer

要生成的編輯結果數量。未提供時通常以 1 張處理。

範圍1 <= value

預設值1

response_format?string

回傳格式，由伺服器端和上游模型的實際能力決定。

回應主體

`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"
    }
  ]
}

授權

請求主體

回應主體

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`