Редактировать изображение

Загрузите референсные изображения и отредактируйте их по текстовому запросу.

POST/v1/images/edits

Загрузите референсные изображения и отредактируйте их по текстовому запросу.

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

bearerAuth

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

Используйте API Key платформы в формате Authorization: Bearer your-api-key.

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

Тело запроса

multipart/form-data

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

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

model*string

ID модели платформы.

prompt*string

Инструкция редактирования; улучшение запроса всегда включено. Длина считается в символах Unicode без начальных и конечных пробелов; строка не может состоять только из пробелов.

Длина1 <= length <= 32000

n?integer

Количество создаваемых изображений.

Диапазон1 <= value <= 10

По умолчанию1

size?string

auto или WIDTHxHEIGHT, по умолчанию auto. Заданная площадь: 655,360–20,000,000 пикселей; соотношение сторон: 1:3–3:1. При заданных размерах не передавайте aspect_ratio и area.

По умолчанию"auto"

aspect_ratio?string

По умолчанию auto; определяется улучшенным запросом, а при редактировании также референсами. Допустимо X:Y, где X и Y — целые числа 1–300, соотношение 1:3–3:1. Только если size не задан или равен auto.

area?string

Уровень площади, по умолчанию 4K. Только если size не задан или равен auto; фактические размеры в data[].size.

Допустимые значения

"1K"
"2K"
"4K"

output_format?string

Формат изображения. jpg и jpeg равнозначны; в ответе используется jpeg.

По умолчанию"jpeg"

Допустимые значения

"jpeg"
"jpg"
"png"
"webp"

response_format?string

Ссылки url действуют 24 часа; b64_json возвращает Base64 без потоковой передачи. Общая выходная площадь Base64 ограничена 20,000,000 пикселей для PNG и 80,000,000 для JPEG/WebP по всем изображениям.

По умолчанию"url"

Допустимые значения

"url"
"b64_json"

output_compression?integer

Качество сжатия JPEG/WebP; чем выше значение, тем больше файл. Для PNG игнорируется.

Диапазон0 <= value <= 100

По умолчанию95

stream?boolean

Возвращать результаты по изображениям через SSE; поддерживается только response_format со значением url.

По умолчаниюfalse

aigc_watermark?boolean

Добавлять видимый водяной знак AIGC; не влияет на скрытый идентификатор в метаданных файла.

По умолчаниюfalse

image*array<>

1–16 референсных изображений. Форматы JPG, JPEG, PNG, WEBP, HEIC, HEIF. Каждое изображение и всё тело запроса — не более 64 MiB каждое; длина стороны 128–8192 пикселей; отношение длинной стороны к короткой не более 4:1. Размер Base64 также учитывается в теле запроса. На каждый файл — поле image; для нескольких файлов допустимо image[]. Порядок загрузки определяет номера изображений.

Элементы1 <= items <= 16

Ссылки на изображения в JSON

JSON-запрос передаёт референсы в массиве объектов images; остальные поля совпадают с загрузкой файлов.

Поле Представление JSON

Поле	Представление JSON
`images[].image_url`	Обязательно. Поддерживаются публичные URL, Base64 Data URL и mm_file://{file_id}. Замените URL примера адресом созданного и сохранённого изображения. Обязательно. Поддерживаются публичные URL, Base64 Data URL и mm_file://{file_id}. Замените URL примера адресом созданного и сохранённого изображения.

images[].image_url

Обязательно. Поддерживаются публичные URL, Base64 Data URL и mm_file://{file_id}. Замените URL примера адресом созданного и сохранённого изображения.

Тело ответа

`application/json`

type*string

created?integer

Метка времени Unix события.

model?string

ID фактически использованной модели.

image_index*integer

Индекс изображения, начиная с 0.

Диапазон0 <= value

url*string

Временная ссылка на созданное изображение.

size?string

Фактические WIDTHxHEIGHT изображения.

output_format?string

Фактический формат вывода.

Допустимые значения

"jpeg"
"png"
"webp"

revised_prompt?string

Запрос, использованный для этого изображения.

curl -X POST "https://api.agtcloud.cn/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="Замени зелёный абажур лампы на цвет слоновой кости, сохрани деревянный стол, фон, освещение и композицию." \
  -F size="2048x2048" \
  -F n="1" \
  -F response_format="url" \
  -F image="@/path/to/lamp.png"

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "Зелёная настольная лампа стоит на деревянном столе перед светлой стеной; мягкий естественный свет освещает абажур и столешницу."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

Рекомендуемый тайм-аут клиента — не менее 600 секунд. После тайм-аута или разрыва соединения генерация может продолжиться; повторная отправка создаёт новый запрос.

API редактирования изображений MiniMaxПараметры запроса и структура ответа.

Редактировать изображение

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

Тело запроса

Ссылки на изображения в JSON

Тело ответа

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

События потокового ответа

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`