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

Правка загруженного изображения по указаниям на естественном языке

POST /api/v1/images/edits принимает multipart/form-data. Требуемое право: images:edit.

Поля формы

Поле	Тип	Обязательно	По умолчанию	Правила
`image`	file	да	—	PNG, JPEG или WebP; не более 10 МиБ и 40 млн пикселей после декодирования
`prompt`	string	да	—	указание по правке, 5–2 000 символов
`aspect_ratio`	string	нет	зависит от исходника	те же публичные соотношения, что и при генерации
`resolution`	string	нет	`2K`	`2K` или `4K`
`count`	integer	нет	`1`	1–4

Сигнатуры файлов проверяются независимо от заявленного MIME-типа. Некорректные, слишком большие или небезопасные изображения дают 400 INVALID_REQUEST либо HTTP 413 с тем же публичным кодом.

Кредиты

Разрешение	Кредитов за результат
`2K`	10
`4K`	20

cURL

curl https://sci-draw.com/api/v1/images/edits \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: revise-figure-7-v2' \
  -F 'image=@figure.png;type=image/png' \
  -F 'prompt=Move the legend below the diagram and increase label contrast' \
  -F 'resolution=2K' \
  -F 'count=1'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('prompt', 'Move the legend below the diagram');
const response = await fetch('https://sci-draw.com/api/v1/images/edits', {
  method: 'POST',

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer

Загруженный исходник — это закрытые входные данные задачи, он никогда не возвращается в ответах по задачам и в логах. Повторные идемпотентные загрузки отбрасываются, а принятые исходники удаляются после получения окончательного результата.

Поля формы

Кредиты

cURL

JavaScript

Python

Оглавление