Введение
Возможности эндпоинта
Исправляет видимые повреждения одного фото: царапины, пятна пыли, плёночное зерно, шум и размытость. Возвращает PNG. Промпт не нужен.
Основные входные данные
Единственное поле — image_url: загрузка JPEG, PNG, WebP или прямая ссылка на файл.
Результат
Один PNG примерно в 1 мегапиксель с исходными пропорциями. Чёрно-белые и сепийные снимки сохраняют свои тона.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Эндпоинт | Редактирование изображения |
| Вход | Одно фото: загрузка JPEG, PNG, WebP или прямая ссылка |
| Выход | PNG, около 1 мегапикселя, исходные пропорции |
| Что исправляет | Царапины, пятна пыли, зерно, шум и размытость |
| Цвет | Сохраняется исходный, без раскрашивания |
| Настройки | Только фото, без других настроек |
Ключевые возможности и особенности
Чистый сепийный портрет за один проход
На тестовом скане были 4 царапины, 7 пылинок, зерно и размытость. Всё это исчезло, глаза, борода и фактура пиджака стали чётче, а кадрирование сохранилось.
Лицо восстановлено с сохранением черт
На том же фрагменте исчезли пылинка на волосах и зерно на коже, а выражение и черты лица совпадают со сканом. Лица особенно важны при восстановлении — начните проверку с них.
Используйте вместе с Photo Colorizer
Восстановление сохраняет исходные тона. Для чёрно-белых и сепийных снимков передайте восстановленный PNG в Photo Colorizer: чистый снимок раскрашивается ровнее, чем поцарапанный.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Скан для восстановления: загрузка JPEG, PNG, WebP или прямая ссылка. Одно фото на запрос; результат — PNG примерно в 1 мегапиксель с теми же пропорциями. Не менее 1 символов |
Стоимость
$0.048 / изображение
Фиксированная цена за восстановленное фото независимо от размера. Неудачные запросы не оплачиваются.
Сценарии использования
Семейные альбомы и снимки из коробок
Очистите сканы портретов бабушек и дедушек, свадебных и отпускных фото для слайд-шоу, печатной книги или семейного чата.
Архивы и краеведческие проекты
Восстановите коллекцию сканов с мелкими царапинами и пылью, чтобы волонтёры занимались подписями, а не ретушью.
Памятные и юбилейные материалы
Подготовьте дорогой сердцу снимок для рамки, программы церемонии или памятного видео без заказа ретуши.
Руководство по промптам и практические советы
Отсканируйте или сфотографируйте снимок
Расправьте снимок, избегайте бликов и включите его целиком в кадр. Инструмент исправляет видимые повреждения; блик на лице убрать сложнее, чем царапину.
Передайте
image_urlЗагрузите скан в JPEG, PNG или WebP либо передайте прямую ссылку на файл. Это весь запрос.
Проверьте лица и добавьте цвет
Сравните глаза и рот с оригиналом в полном размере. Для чёрно-белого снимка передайте восстановленный PNG в Photo Colorizer по пути /models/photo-colorizer-v1.
Введение
Old Photo Restorer — эндпоинт с одним полем для сканов печатных фото. Отправьте снимок в image_url и получите его без царапин, пятен пыли, зерна и размытости. Раскрашивания нет, промпт не нужен.
Запрос
{
"image_url": "https://example.com/scan.jpg"
}
Результаты тестирования
К сепийному скану портрета на крыше 640×960 мы добавили типичные повреждения: 4 длинные царапины, 7 пылинок, зерно, размытость и сильное сжатие JPEG. Примерно через 17 секунд вернулся PNG 832×1248 без царапин и пылинок, с заметно более чёткими лицом, бородой и пиджаком. Мужчина остался узнаваемым. Слабые облака сгладились до ровного светлого неба, сепия стала светлее.
Чистое цветное фото 2048×1152 вернулось в 1360×768 с сохранёнными цветами и чуть более гладкой кожей. Это показывает правило размера: любой результат имеет около 1 мегапикселя.
Порядок работы
Восстановление выполняется асинхронно: создайте задачу, опрашивайте её до завершения и скачайте PNG из хранилища SpicyAPI. Каждый запрос обрабатывает одно фото по фиксированной цене. Неудачные запросы бесплатны.
Советы
- Сканируйте в достаточном разрешении и обрежьте страницу альбома или рамку перед отправкой.
- Блики и отражения удалить сложнее, чем царапины: фотографируйте снимки без вспышки.
- Нужен цвет? Передайте восстановленный PNG в Photo Colorizer (
/models/photo-colorizer-v1). - Нужен файл крупнее для печати? После восстановления используйте Image Upscaler (
/models/image-upscaler-v1).
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/photo-restorer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.




