Редактирование изображения через JSON

Редактирование одного или нескольких изображений Grok по URL в JSON.

Запрос использует application/json и передаёт общедоступные URL изображений для редактирования одного или нескольких изображений.

POST/v1/images/edits

Редактируйте одно или несколько опорных изображений по текстовой инструкции. Запрос должен использовать application/json и передавать общедоступные URL изображений через image или images.

Эта структура JSON-запроса с URL применима только к моделям, поддерживающим редактирование изображений Grok.

Используйте /v1/images/edits, а не /v1/edits. Для нескольких опорных изображений используйте images; использовать reference_images не рекомендуется.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Параметры запроса на редактирование изображений Grok. Требуется хотя бы одно из image и images.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели для редактирования изображений. Такой формат запроса поддерживают grok-imagine-image и grok-imagine-image-pro; фактическая доступность определяется списком моделей текущего ключа API и возможностями канала.

Длина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"
    }
  ]
}

Редактирование изображения через JSON

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`