Введение
Возможности эндпоинта
Добавляет цвет одному чёрно-белому, сепийному или выцветшему фото и возвращает JPEG. Цвета определяются по снимку; промпта и палитры нет.
Основные входные данные
Единственное поле — image_url: фото в виде загрузки JPEG, PNG, WebP или прямой ссылки.
Результат
Один JPEG с размерами примерно в 2–3 раза больше исходных.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Эндпоинт | Редактирование изображения |
| Вход | Одно чёрно-белое, сепийное или выцветшее фото |
| Выход | JPEG, размеры примерно 2–3× от исходных |
| Настройки | Только фото, без других настроек |
| Лучше всего подходит | Чистые сканы; повреждения сначала восстановите |
Ключевые возможности и особенности
Серый портрет на крыше превратился в закатную сцену
Из обычного чёрно-белого фото получились тёплая кожа, коричневый пиджак, закатное небо от синего до оранжевого и светящиеся окна города. Этих цветов в файле не было — они определены по формам и тонам.
От поцарапанной сепии к чистому цветному фото
Слева — повреждённый скан, в центре — после Old Photo Restorer, справа — восстановленный файл после Photo Colorizer. Раскрашивание очищенного снимка дало ровный тон кожи и гладкое небо.
Цвета определяются по изображению
Чёрно-белое фото не содержит цветовой информации: каждый оттенок — интерпретация сцены моделью. Считайте результат естественно выглядящей версией и храните рядом оригинал.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Чёрно-белое, сепийное или выцветшее фото для раскрашивания: загрузка JPEG, PNG, WebP или прямая ссылка. Результат — JPEG с размерами примерно в 2–3 раза больше. Не менее 1 символов |
Стоимость
$0.06 / изображение
Фиксированная цена за раскрашенное фото, увеличение результата без доплаты. Неудачные запросы не оплачиваются.
Сценарии использования
Оживите семейную историю
Подарите родным цветной портрет родителей или бабушек и дедушек, чтобы поместить его рядом с оригиналом в альбоме или на памятной странице.
Исторические и документальные материалы
Раскрасьте архивные кадры для видеоэссе, музейной подписи или поста и сохраните оригинал рядом для сравнения.
Процесс реставрации
Используйте после Old Photo Restorer: сначала восстановление, затем цвет и при необходимости увеличение для печати.
Руководство по промптам и практические советы
Начните с чистого скана
Лучше всего подходит снимок без царапин и пыли. Повреждённое фото сначала обработайте в Old Photo Restorer (/models/photo-restorer-v1), затем раскрасьте результат.
Передайте
image_urlЗагрузите чёрно-белое или сепийное фото в JPEG, PNG или WebP либо передайте прямую ссылку.
Проверьте подобранные цвета
Цвета волос, глаз и одежды определяются предположительно. Если вы знаете настоящие цвета, используйте результат как основу для ручной корректировки.
Введение
Photo Colorizer добавляет естественный цвет чёрно-белым, сепийным и выцветшим фото. Единственный вход — image_url; цвета кожи, волос, одежды, неба и зданий определяются по формам и тонам снимка.
Запрос
{
"image_url": "https://example.com/grandparents-1958.jpg"
}
Результаты тестирования
Чёрно-белый портрет мужчины на крыше 768×1152 примерно через 17 секунд вернулся как JPEG 1664×2496: тёплая кожа, коричневый пиджак, белая футболка и оранжевый закат за синим силуэтом города. Фото двух людей в баре 1024×576 вернулось в 2848×1600 с зелёными и красными винными бутылками и кремовым свитером. Волосы женщины стали каштановыми, хотя на цветном фото, которое мы перевели в чёрно-белое, они были рыжими. Такие предположения стоит проверять.
Мы также раскрасили поцарапанный сепийный скан после Old Photo Restorer. У восстановленного и затем раскрашенного портрета получились ровная кожа и чистое небо.
Порядок работы
Вызов асинхронный: создайте задачу, опрашивайте её до завершения и скачайте JPEG из хранилища SpicyAPI. Один запрос — одно фото по фиксированной цене; неудачные запросы бесплатны.
Советы
- Сначала уберите царапины и пыль в Old Photo Restorer (
/models/photo-restorer-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-colorizer-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.




