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	13	ТИП API - Удаление фона
backtype	1	Обязательно указать backtype=1

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

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

    $apikey = "781569cb_my_api_key_4b56d330e"; //Ваш Ключ-API
    $imageData = file_get_contents( '../pics/mypic.jpg' ); //Путь к локальному изображению или url-ссылка на него
    if ($imageData === false) die("Ошибка: Не удалось прочитать файл");

    //Настройки обработки
    $settings = ['job_type'  => 13, 'backtype'=> 1];

    // Формируем данные для API
    $postData = ['apikey' => $apikey,'image' => ['data' => 'data:image/jpeg;base64,' . base64_encode($imageData) ],'settings' => $settings];
    unset($imageData);
    // Отправляем запрос к API
    $ch = curl_init('http://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);

    if ($httpCode==200){
        $json = json_decode($response);
        if ( $json->success ){
            $resultPng = $json->result->result_url; //ссылка на итоговое изображение
            file_put_contents('result.png', file_get_contents($resultPng) ); //сохраняем итоговое изображение с прозрачным фоном в result.png
            
            // >>> ДЛЯ ПРИМЕРА: сохраняем итоговое изображение с зелёным фоном в result.jpg
            $sourceImage = imagecreatefrompng($resultPng );
            $width = imagesx($sourceImage);
            $height = imagesy($sourceImage);
            $resultImage = imagecreatetruecolor($width, $height);
            $backgroundColor = imagecolorallocate($resultImage, 50, 200, 50);
            imagefill($resultImage, 0, 0, $backgroundColor);
            imagecopy($resultImage, $sourceImage, 0, 0, 0, 0, $width, $height);
            imagejpeg($resultImage, 'result.jpg', 85);
            imagedestroy($sourceImage);
            imagedestroy($resultImage);
            // <<< 
        }
    }
    // Выводим ответ API (в 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.png",  // Ссылка на изображение - результат
        "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 (Удаление фона)