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	12	ТИП API - АПСКЕЙЛ
upscaleType	dw	Модель "Увеличение размера"
zoomFactor	2 / 4	Увеличить в 2 или в 4 раза. (разная стоимость)

⚙️ Увеличение качества изображения:

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

Параметр	Значения	Описание
job_type	12	ТИП API - АПСКЕЙЛ
upscaleType	nb	Модель "Увеличение качества"
nb_size	1K / 2K / 4K	Итоговое разрешение изображения. (разная стоимость)

Пример использования (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'  => 12, // тип API: "АПСКЕЙЛ" 
        'upscaleType'=> 'nb',  // Модель: "Увеличение качества"
        'nb_size'   => '4K',
    ];

    // Формируем данные для 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 (Апскейл)