API - Реставрация старых фотографий

Реставрация, восстановление, раскрашивание старых фотографий

Выберите тип API:

Генерация изображений Удаление текста и логотипов Реставрация фото Улучшение качества (апскейл) Удаление/Замена фона

Эндпоинт:

Ссылка на api: https://photocleaner.ru/api/v2/api.php

По данной ссылке вы получаете ответ в формате JSON, в котором будет ссылка на обработанное изображение или пояснения, в случае ошибки.

Ваш API-КЛЮЧ: НЕОБХОДИМО АВТОРИЗОВАТЬСЯ

Для получения ключа, вы должны авторизоваться на ФотоКлинере...

Обязательные параметры запроса:

apikey	Ключ API	Укажите в данном параметре ваш индивидуальный ключ API. Для работы API ваш ключ, должен иметь положительный баланс.
image	Данные референсного изображения	Cодержимое обрабатываемого изображения (ImageData в формате base64). Принимаются только изображения Jpeg, Png, Gif, Webp весом до 10 мб и разрешением не более 4500 в ширину и длину.
settings	Настройки обработки	Настройки обработки в формате JSON. Внимание, для каждого типа API настройки и их количество различны...

Все запросы отправляются методом POST в формате JSON.

Отправка нескольких изображений в одном запросе:

Если вам требуется отправить более одного референсного изображения, то необходимо сначала загрузить все изображения отдельными запросами к API, а на последнем будет произведена обработка. Делается это следующим образом:

<?php
    define('TIMEOUT', 300); // Таймаут выполнения (с запасом)
    define('APIKEY', "781569cb_my_api_key_4b56d330e"); // Таймаут выполнения (с запасом)
    ini_set('max_execution_time', TIMEOUT); 

    function send2PCapi($data){
        $ch = curl_init('http://photocleaner.ru/api/v2/api.php');
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, TIMEOUT); 
        $response = curl_exec($ch); //JSON Ответ
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        return array($httpCode, $response);
    }

    $images = array( "my_photo.jpg" , "pidjak.jpg" , "automobile.jpg"  );
    $settings = [
        'job_type'  => 20, 
        'model'  => 'NanoBanana', 
        'prompt' => 'Я на первом фото. Одень меня в костюм с третьего фото и поставь рядом с авто на втором фото. Должно создаваться впечатление, что это мой автомобиль. ', 
        'nb_aspect'  => '9:16'
    ];

    foreach($images as $num => $image){
        $imageData = file_get_contents( $image ); 
        if ($imageData === false) die("Ошибка: Не удалось прочитать файл");

        $postData = ['image' => ['data' => 'data:image/jpeg;base64,' . base64_encode($imageData) ],'apikey' => APIKEY, 'settings' => $settings, 'batch_count' => count($images), 'batch_num' => $num+1];
        if ($groupId) $postData['group_id'] = $groupId;
        unset($imageData);

        list($httpCode, $response) = send2PCapi($postData);
        $httpCode == 200 or die("Ошибка загрузки API: $response");
        unset($postData);

        $api_json = json_decode($response, true);
        $api_json['success'] or die("Ошибка API: $response");

        if (!$groupId) $groupId = $api_json['result']['group_id'];
        if (!$api_json['result']['continue']) break;
    }

    // Возвращаем ответ (в JSON)
    http_response_code($httpCode);
    header('Content-Type: application/json');
    echo $response;
?>

НАСТРОЙКИ РЕСТАВРАЦИИ ФОТО:

⚙️ Простая реставрация:

Быстрая и дешёвая. Подходит для большинства задач.

Параметр	Значения	Описание
job_type	28	ТИП API - реставрация фото
rstvr_type	1	Тип реставрации - простая
rstvr_1	false/true	Убрать дефекты и повреждения
rstvr_2	false/true	Убрать блики, засветы, пересветы
rstvr_3	false/true	Разукрасить (сделать цветным)
rstvr_4	false/true	Повысить качество и детализацию

⚙️ PRO реставрация:

Более дорогая модель. Глубокий анализ фото. Работает дольше, имеет больше настроек и позволяет добиться максимального качества (до 4K).

Параметр	Значения	Описание
job_type	28	ТИП API - реставрация фото
rstvr_type	2	Тип реставрации - PRO
nb_size	auto / 1K / 2K / 4K	Итоговое разрешение фото. (разная стоимость)
nb_aspect	auto / 21:9 / 16:9 / 5:4 / 4:3 / 3:2 / 1:1 / 9:16 / 4:5 / 3:4 / 2:3	Итоговое соотношение сторон.
rstvr2_1	false/true	Убрать дефекты и повреждения
rstvr2_2	false/true	Убрать мусор и пятна
rstvr2_3	false/true	Убрать блики, засветы, пересветы
rstvr2_4	false/true	Восстановить лица и глаза
rstvr2_5	false/true	Разукрасить (сделать цветным)
rstvr2_6	false/true	Повысить качество и детализацию
rstvr3_1	false/true	Качество современной фотокамеры
rstvr3_2	false/true	Современная причёска
rstvr3_3	false/true	Современный макияж
rstvr3_4	false/true	Современная одежда
rstvr3_5	false/true	Современная обстановка
rstvr3_6	false/true	Современная архитектура и техника

Пример использования (PHP):

<?php
    $TimeOut = 300;  // Таймаут выполнения (с запасом)
    ini_set('max_execution_time', $TimeOut); 

    $apikey = "781569cb_my_api_key_4b56d330e"; //Ваш Ключ-API
    $piclink = '../pics/mypic.jpg'; //Путь к локальному изображению или url-ссылка на него

    //Настройки обработки
    $settings = [
        'job_type'  => 28, // API: "Реставрация" 
        'rstvr_type'=> 2,  // PRO
        'nb_size'   => '2K',
        'nb_aspect' => '4:3',
        'rstvr2_1'   => true,
        'rstvr2_2'   => true,
        'rstvr2_5'   => true,
        'rstvr3_1'   => true
    ];

    // Формируем данные для API
    $postData = [
        'apikey' => $apikey,
        'image' => ['data' => 'data:image/jpeg;base64,' . base64_encode( file_get_contents($piclink) ) ],
        'settings' => $settings
    ];

    // Отправляем запрос к API
    $ch = curl_init('https://photocleaner.ru/api/v2/api.php');
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, $TimeOut); 

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    unset($postData);

    // Возвращаем ответ (в JSON)
    http_response_code($httpCode);
    header('Content-Type: application/json');
    echo $response;
?>

Не забудьте в данном коде прописать ваш api-ключ и указать путь к исходному файлу изображения (piclink).

ПРИМЕР УСПЕШНОГО ОТВЕТА API (JSON):

{
    "success":true, // Успешный ответ
    "result":
    {
        "pic_id":552918, // ID изображения
        "original_format":"jpeg", // Исходный формат изображения
        "original_size":41897, // Исходный вес изображения
        "result_url":"https://photocleaner.ru/img_cache/755628736/c50549d20cdc6e5fc0e5b3ba9cc7a6b1.jpg",  // Ссылка на изображение - результат
        "result_format":"jpeg", // Формат изображения результата
        "result_size":42653, // Вес изображения результата
        "processing_time":25.34, // Длительность обработки в секундах
        "price":1.2, // Стоимость обработки (в 💎)
        "balance":251.8, // Остаток вашего баланса (в 💎)
    }
}

Пример ответа API при ошибке (JSON):

{
    "success":false,
    "error_code":305, //Код ошибки
    "error":"Файл слишком большой (макс. 10MB)", //Описание ошибки
    "price":null,
    "balance":251.8
}

PhotoCleaner API (Реставрация)