2 кредита за вызов
API колоризации фотографий
Превращайте чёрно-белые фотографии в изображения с естественным цветом одним запросом. При желании устранение разрывов в том же вызове — и никакого ручного подбора цвета ни на одном шаге.
- REST · JSON
- Без водяного знака
- Ничего не хранится
POST /v1/colorize-photo
Что такое API колоризации фотографий?
API колоризации ImgGen AI — это REST-эндпоинт, который добавляет реалистичный цвет чёрно-белым и полутоновым изображениям. Модель выводит правдоподобные цвета кожи, одежды, растительности, неба и материалов из самого содержимого изображения, поэтому эталонная палитра и ручной выбор не нужны. Результат в цвете возвращается в том же ответе.
Это один из семи эндпоинтов API редактирования изображений ImgGen AI: у всех общий ключ API, общий базовый URL и одинаковый формат запроса и ответа. Если эта возможность нужна вам ещё и в браузере, а не только из кода, — та же модель ИИ работает в инструменте Colorize Photo.
Параметры запроса
Отправьте POST-запрос на https://app.imggen.ai/v1/colorize-photo с аутентификацией по ключу API в заголовке Authorization.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
| image | file | ОБЯЗАТЕЛЬНЫЙ | — | Устраняет царапины и разрывы во время колоризации. |
| removeTears | boolean | необязательный | false | Repair scratches and tears while colorizing. |
Как встроить API колоризации фотографий?
Создайте ключ API в аккаунте ImgGen, сохраните его в переменной окружения и вызовите эндпоинт. Вот один и тот же запрос на cURL, Node.js и Python.
curl --request POST \
--url 'https://app.imggen.ai/v1/colorize-photo' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form removeTears=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');
const res = await fetch('https://app.imggen.ai/v1/colorize-photo', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/colorize-photo",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"removeTears": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))Ответ
Успешный вызов возвращает JSON. Результат приходит в кодировке base64 — декодируйте его перед записью на диск или в объектное хранилище. Каждый успешный ответ также содержит заголовок X-Credit-Remaining с вашим балансом после вызова.
{
"success": true,
"message": "Image colorized successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}Ограничения и поведение, о которых стоит знать
Эндпоинт принимает JPEG (JPG), PNG и WebP с максимальным размером файла 25 МБ и отвечает синхронно в пределах 60 секунд — не нужно опрашивать задачу и настраивать вебхук.
Цвет выводится, а не восстанавливается
Модель предсказывает правдоподобный цвет по содержимому изображения. Она даёт убедительную интерпретацию, а не исторически подтверждённую — об этом стоит говорить прямо, если вы показываете результат пользователям.
Восстанавливайте при колоризации
Поставьте removeTears=true, чтобы устранить царапины и физические повреждения в том же проходе, без второго вызова эндпоинта реставрации.
Изображения, уже имеющие цвет
Эндпоинт рассчитан на полутоновый вход. Отправлять изображение, в котором цвет уже есть, бессмысленно — используйте эндпоинт реставрации, если цель в восстановлении.
Для чего используют API колоризации фотографий?
Где команды используют этот эндпоинт в продакшене, чтобы обрабатывать изображения программно и в больших объёмах.
Продукты о семейной истории
Дайте пользователям колоризировать унаследованные фотографии прямо в приложении — как платное улучшение или вовлекающую функцию.
Редакции и издательства
Готовьте цветные версии архивных фотографий для материалов и ретроспектив, ясно помечая их как интерпретации.
Массовая обработка архивов
Создавайте цветные копии для доступа по всей полутоновой коллекции, оставляя оригиналы нетронутыми.
Памятные и подарочные сервисы
Колоризируйте и восстанавливайте загруженную клиентом фотографию автоматически в рамках обработки заказа.
Сколько стоит API колоризации фотографий?
Каждый успешный вызов стоит 2 кредита, поэтому фактическая стоимость изображения зависит от вашего тарифа. Кредиты берутся из вашего тарифа и общие для всех эндпоинтов и веб-редактора, так что отдельную квоту на каждый инструмент покупать не нужно. Неудачный вызов возвращается автоматически. Все подробности — на странице тарифов.
| Тариф | Цена | Кредиты | API |
|---|---|---|---|
| Free | $0 | 50 бесплатных кредитов единоразово | Без доступа к API |
| Starter | $9.99 / month | 400 кредитов / месяц | Доступ к API включён |
| Pro | $29.99 / month | 1 400 кредитов / месяц | Доступ к API + приоритетная поддержка |
| Enterprise | Custom | Индивидуальный объём | Выделенная инфраструктура |
Стоимость в кредитах и лимиты последний раз проверены 2026-08-27.
Связанные эндпоинты и инструменты
Команды, которые используют API колоризации фотографий, обычно следом берут эти.
Также доступны: Удаление фона, Удаление водяных знаков, Удаление текста, Генерация изображений.
Вопросы об API колоризации фотографий
- Это HTTP-эндпоинт, который принимает чёрно-белое изображение и возвращает цветную версию. Модель читает содержимое фотографии — лица, одежду, растительность, небо, материалы — и предсказывает подходящие цвета, так что вы получаете естественный результат, не задавая палитру.
- Они правдоподобны, но не подтверждены. Модель не знает, какого цвета на самом деле был конкретный пиджак в 1953 году; она выдаёт наиболее вероятную раскраску с учётом всего, что видно в кадре. Тона кожи, растительность и небо обычно убедительны, потому что варьируются в узком диапазоне; одежда, окрашенные поверхности и другие объекты с произвольным цветом — обоснованные догадки. Для исторического материала подавайте результат как интерпретацию.
- Два кредита за успешный вызов. В Starter входит 400 кредитов в месяц за 9,99 $, в Pro — 1 400 за 29,99 $, и неиспользованные кредиты переносятся, пока подписка активна.
- Создайте ключ API в аккаунте ImgGen и отправьте POST-запросом multipart-форму с полем image на https://app.imggen.ai/v1/colorize-photo, аутентифицируясь заголовком Authorization: Bearer. Декодируйте поле image из base64 в JSON-ответе и запишите его туда, где вы храните файлы. Примеры на cURL, Node.js и Python есть на этой странице.
- Этот эндпоинт рассчитан на добавление цвета и при желании может устранить разрывы. Эндпоинт реставрации рассчитан на устранение повреждений и при желании может добавить цвет. Если фотография в первую очередь повреждена — берите реставрацию; если она просто чёрно-белая — этот.
- API принимает файлы JPEG (JPG), PNG и WebP размером до 25 МБ на изображение. Результат возвращается в JSON-ответе в виде изображения в кодировке base64.
- Нет. API не хранит состояние: он не создаёт проект, не сохраняет файл и не оставляет у себя ваше изображение. Загруженный файл записывается во временный объект, обрабатывается и удаляется сразу после отправки ответа. Сохраняется только запись в журнале использования о том, что вызов состоялся и сколько кредитов он стоил. Ваши изображения никогда не используются для обучения моделей.
Начать
Начните вызывать API колоризации фотографий
Один ключ открывает все семь эндпоинтов. Без водяного знака, с полными коммерческими правами, и ничто из отправленного вами не сохраняется после возврата ответа.
Получить ключ API