PhotoCleaner API (Генерация)

Генерация изменение и ретушь изображений с помощью топовых нейросетей

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

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

Эндпоинт:

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

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

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

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

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

1. Все запросы отправляются методом POST в формате JSON.
2. Все модели поддерживают как генерацию изображений по промпту с нуля, так и редактирование референсных изображений, например ваших фото. Если вам нужно отредактировать изображение отправьте его в параметре image вместе с запросом.

НАСТРОЙКИ AI-МОДЕЛЕЙ:

У нас доступны многие модели нейросетей. Все они имеют различне возможности, время работы, параметры и стоимость. Для всех моделей обязательны 3 параметра: job_type, model и prompt. Далее описаниы настройки для каждой отдельной модели нейросети.

⚙️ Nano Banana:

Доступны 3 модели: Nano Banana, Nano Banana 2, Nano Banana PRO.

Параметр	Значения	Описание
job_type	20	ТИП API: AI-Генерация
model	NanoBanana / nanobanana_v2 / nanobanana_pro	модель нейросети
prompt	ваш промпт	Текстовый запрос на любом языке, в свободной форме
nb_aspect	auto / 1:1 / 2:3 / 3:4 / 4:5 / 9:16 / 3:2 / 4:3 / 5:4 / 16:9	Соотношение сторон
nb_size	auto / 1K / 2K / 4K	Размер(разрешение) итогового изображения. Разрешения '2K' и '4K' поддерживают только модели nanobanana_v2 и nanobanana_pro.

⚙️ Sora (GPT Images 2):

Параметр	Значения	Описание
job_type	20	ТИП API: AI-Генерация
model	Sora	модель нейросети
prompt	ваш промпт	Текстовый запрос на любом языке, в свободной форме
nb_aspect	auto / 1:1 / 2:3 / 3:4 / 4:5 / 9:16 / 3:2 / 4:3 / 5:4 / 16:9	Соотношение сторон
nb_size	auto / 1K / 2K / 4K	Размер(разрешение) итогового изображения. Разрешения '2K' и '4K' поддерживают только модели nanobanana_v2 и nanobanana_pro.

⚙️ SeeDream:

Доступны 2 модели: SeeDream 4 и SeeDream 4.5.

Параметр	Значения	Описание
job_type	20	ТИП API: AI-Генерация
model	SeeDream4 / SeeDream45	модель нейросети
prompt	ваш промпт	Текстовый запрос на любом языке, в свободной форме
sd_size4	1K: auto / 1024x1024 / 1200x896 / 896x1200 / 1376x768 / 768x1376 2K: 2048x2048 / 2400x1792 / 1792x2400 / 2752x1536 / 1536x2752	Размер(разрешение) итогового изображения (только для SeeDream 4 ).
sd_size45	2K: auto / 2048x2048 / 2400x1792 / 1792x2400 / 2752x1536 / 1536x2752 4K: 4096x4096 / 4608x3456 / 3456x4608 / 4608x2592	Размер(разрешение) итогового изображения (только для SeeDream 4.5 ) .

Если вы используете версию 4, то указывается параметр sd_size4. Если версию 4.5 то указывается параметр sd_size45.

⚙️ Flux 2 (Klein):

Параметр	Значения	Описание
job_type	20	ТИП API: AI-Генерация
model	Flux2-klein	модель нейросети
prompt	ваш промпт	Текстовый запрос на любом языке, в свободной форме
aspect_ratio	auto / 1:1 / 2:3 / 3:4 / 9:16 / 3:2 / 4:3 / 16:9	Соотношение сторон

⚙️ Grok:

Параметр	Значения	Описание
job_type	20	ТИП API: AI-Генерация
model	Grok	модель нейросети
prompt	ваш промпт	Текстовый запрос на любом языке, в свободной форме
aspect_ratio	auto / 1:1 / 2:3 / 3:4 / 9:16 / 3:2 / 4:3 / 16:9	Соотношение сторон

⚙️ Qwen Images:

Параметр	Значения	Описание
job_type	20	ТИП API: AI-Генерация
model	Qwen	модель нейросети
prompt	ваш промпт	Текстовый запрос на любом языке, в свободной форме
q_size	auto / 1600x1600 / 1600x1200 / 1584x1056 / 1056x1584 / 1200x1600	Размер(разрешение) итогового изображения.

ГЕНЕРАЦИЯ ИЗОБРАЖЕНИЙ

Пример генерации Nano Banana 2 (PHP):

<?php $TimeOut = 300; // Таймаут выполнения (с запасом) ini_set('max_execution_time', $TimeOut); $apikey = "781569cb_my_api_key_4b56d330e"; //Ваш Ключ-API //Настройки обработки $settings = [ 'job_type' => 20, 'model' => 'nanobanana_v2', 'prompt' => 'Нарисуй молодую женщину в бикини на пляже, с бокалом мартини.', 'nb_aspect' => '9:16', 'nb_size' => '2K', ]; // Отправляем запрос к API $ch = curl_init('http://photocleaner.ru/api/v2/api.php'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode( ['apikey' => $apikey, 'settings' => $settings] )); 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); // Возвращаем ответ (в JSON) http_response_code($httpCode); header('Content-Type: application/json'); echo $response; ?>
Не забудьте в данном коде прописать ваш api-ключ и указать путь к исходному файлу изображения (piclink).

Пример настроек для SeeDream 4.5:

$settings = [ 'job_type' => 20, 'model' => 'SeeDream45', 'prompt' => 'Нарисуй креветку, которая играет в настольный тенис с богомолом.', 'sd_size45' => '2400x1792' //2K, 4:3 ];

Пример настроек для Grok:

$settings = [ 'job_type' => 20, 'model' => 'Grok', 'prompt' => 'Придумай логотип для агентства недвижимости, которое называется "ваш дом"', 'aspect_ratio' => '1:1' ];

Пример настроек для Qwen:

$settings = [ 'job_type' => 20, 'model' => 'Qwen', 'prompt' => 'Нарисуй сказочный лес в котором бобры катаются на единорогах.', 'q_size' => '1600x1200' ];

РЕДАКТИРОВАНИЕ ИЗОБРАЖЕНИЙ ( И ФОТО )

Пример редактирования фото с помощью Nano Banana:

Когда требуется обработать нейросетью ваше референсное изображение, отправьте его содержимое в параметре 'image'. <?php $TimeOut = 300; // Таймаут выполнения (с запасом) ini_set('max_execution_time', $TimeOut); $apikey = "781569cb_my_api_key_4b56d330e"; //Ваш Ключ-API $imageData = file_get_contents( 'https://photocleaner.ru/tmp_pics/553252_in.jpg' ); //Путь к локальному изображению или url-ссылка на него if ($imageData === false) die("Ошибка: Не удалось прочитать файл"); //Настройки обработки $settings = [ 'job_type' => 20, 'model' => 'NanoBanana', 'prompt' => 'Перемести девушку с этого фото на красивый тропический пляж. Пусть она будет одета в лёгкое светлое платье.', 'nb_aspect' => 'auto' ]; // Формируем данные для 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); //JSON Ответ $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, а на последнем будет произведена обработка. Делается это следующим образом: <?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; ?>

ПРИМЕР УСПЕШНОГО ОТВЕТА 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 }