LogoLogoДокументация API
LogoLogoДокументация API
Главная страница
ОбзорАутентификация и идемпотентностьГенерация изображенийРедактирование изображенийКонвертация изображенийПостроение графиковЗадачи и ограниченное ожиданиеКредитыОшибкиОграничения частоты и параллелизмаИстория изменений API
Документация API

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

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

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

Поля формы

ПолеТипОбязательноПо умолчаниюПравила
imagefileда—PNG, JPEG или WebP; не более 10 МиБ и 40 млн пикселей после декодирования
promptstringда—указание по правке, 5–2 000 символов
aspect_ratiostringнетзависит от исходникате же публичные соотношения, что и при генерации
resolutionstringнет2K2K или 4K
countintegerнет11–4

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

Кредиты

РазрешениеКредитов за результат
2K10
4K20

cURL

Генерация изображений

Создание задач «текст в изображение»

Конвертация изображений

Преобразование изображений в SVG, PPTX, PNG, PDF или TIFF

Оглавление

Поля формы
Кредиты
cURL
JavaScript
Python
Размеры результата
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',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"prompt": "Move the legend below the diagram"},
    )

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

Размеры результата

2K и 4K обозначают уровни размера, а не фиксированную длину стороны. В таблице указаны фактические размеры в пикселях. Неподдерживаемые пропорции возвращают HTTP 400 (INVALID_REQUEST) до создания задания или резервирования кредитов. При редактировании без aspect_ratio пропорции исходника должны быть в пределах от 1:3 до 3:1 и соответствовать уровню размера (не менее 6 млн пикселей для 4K); иначе укажите поддерживаемые пропорции результата.

aspect_ratio2K4K
1:12048×20482880×2880
16:92560×14403840×2160
9:161440×25602160×3840
4:32304×17283264×2448
3:41728×23042448×3264
3:22496×16643504×2336
2:31664×24962336×3504
5:42240×17923200×2560
4:51792×22402560×3200
21:93136×13443808×1632