PHPackages                             acetonesoft/acetone-api-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. acetonesoft/acetone-api-php

ActiveLibrary[API Development](/categories/api)

acetonesoft/acetone-api-php
===========================

PHP class for API of AceTone.AI - remove background form your images

v1.1.2(4w ago)324MITPHPPHP >=7.4

Since Jul 30Pushed 4w ago1 watchersCompare

[ Source](https://github.com/acetonesoft/acetone-api-php)[ Packagist](https://packagist.org/packages/acetonesoft/acetone-api-php)[ RSS](/packages/acetonesoft-acetone-api-php/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (4)Dependencies (4)Versions (5)Used By (0)

PHP-клиент для API AceTone.ai
=============================

[](#php-клиент-для-api-acetoneai)

[English](README.en.md) | **Русский**

С помощью API AceTone.ai можно программно удалять фон с изображений. Также фон можно залить сплошным цветом, линейным или радиальным градиентом, размыть или обесцветить, либо заменить другим изображением. Кроме того, клиент поддерживает удаление объектов по маске и улучшение/апскейл изображения.

**ВАЖНО:** Нужно зарегистрировать аккаунт и получить API-ключ на

[![cover](cover.jpg)](cover.jpg)

Установка
---------

[](#установка)

Установка через composer

```
composer require acetonesoft/acetone-api-php

```

Требуется PHP >= 7.4 и зависимость `guzzlehttp/guzzle`.

Быстрый старт
-------------

[](#быстрый-старт)

```
use AcetoneSoft\Acetone\AcetoneApi;

$acetone = new AcetoneApi($apiKey);
$acetone->fromFile($sourceImageFile)->save($targetImageFile);
```

Два стиля API
-------------

[](#два-стиля-api)

Клиент предоставляет два взаимозаменяемых стиля:

1. **Fluent-билдер** — задайте источник через `fromFile()` / `fromUrl()` / `fromString()` / `fromBase64()`, соедините цепочкой модификаторы, затем вызовите терминальный геттер (`get()` / `getObject()` / `getEnhanced()`) или сейвер (`save()` / `saveObject()` / `saveEnhanced()`).
2. **One-shot методы** — принимают исходное изображение как **бинарную строку** и возвращают результат тоже бинарной строкой (см. [One-shot методы](#one-shot-%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D1%8B)).

HTTP-запрос не выполняется, пока не вызван терминальный геттер/сейвер.

Расширенное использование
-------------------------

[](#расширенное-использование)

### Источники

[](#источники)

Изображение можно получить по ссылке, из файла, из бинарной строки или из base64-строки.

```
// Исходное изображение по URL
$acetone->fromUrl($imageUrl)->save($outFile);

// Исходное изображение из файла
$acetone->fromFile($imageFile)->save($outFile);

// Изображение из бинарной строки
$acetone->fromString($imageString)->save($outFile);

// Изображение из base64-строки
$acetone->fromBase64($base64)->save($outFile);
```

### Манипуляции с фоном

[](#манипуляции-с-фоном)

```
// Просто удалить фон
$acetone->fromFile($imageFile)->bgRemove()->save($outFile);

// Задать цвет фона (hex с "#" или без, короткий hex либо RGB-массив)
$acetone->fromFile($imageFile)->bgColor('f00')->save($outFile);
$acetone->fromFile($imageFile)->bgColor('#f00')->save($outFile);
$acetone->fromFile($imageFile)->bgColor([255, 0, 0])->save($outFile);

// Залить фон линейным градиентом (второй аргумент — угол вектора градиента)
$colors = ['f00', '33c'];
$vector = -30;
$acetone->fromFile($imageFile)->bgGradient($colors, $vector)->save($outFile);

// Залить фон радиальным градиентом (второй аргумент — центр [x, y])
$colors = ['f00', '33c'];
$center = [120, 240];
$acetone->fromFile($imageFile)->bgRadialGradient($colors, $center)->save($outFile);

// Размыть фон (степень размытия)
$acetone->fromFile($imageFile)->bgBlur(20)->save($outFile);

// Обесцветить фон
$acetone->fromFile($imageFile)->bgGrayscale()->save($outFile);

// Задать фоновое изображение из бинарной строки
$bgImage = file_get_contents('path/to/new/background');
$acetone->fromFile($imageFile)->bgImage($bgImage)->save($outFile);

// Либо задать фоновое изображение из файла
$acetone->fromFile($imageFile)->bgImageFile('path/to/new/background')->save($outFile);
```

### Изменение размера результата

[](#изменение-размера-результата)

`size(width, height, $fgFit, $bgFit)`. Константы вписывания: `IMG_FIT_NONE`, `IMG_FIT_COVER`, `IMG_FIT_CONTAIN`, `IMG_FIT_STRETCH`.

```
$acetone->fromFile($imageFile)
    ->size(800, 600, AcetoneApi::IMG_FIT_COVER, AcetoneApi::IMG_FIT_COVER)
    ->bgImageFile($imageFileBg)
    ->save($outFile);
```

### Обрезка результата по границам объекта

[](#обрезка-результата-по-границам-объекта)

```
$acetone->fromFile($imageFile)
    ->crop()
    ->get();
```

### Качество вывода и точное вырезание

[](#качество-вывода-и-точное-вырезание)

```
// Задать качество (1-100) и включить режим точного вырезания
$acetone->fromFile($imageFile)
    ->quality(90)
    ->exact(true)
    ->save($outFile);
```

### Тень

[](#тень)

```
// Добавить падающую тень под объектом
// shadow(power, offsetX, offsetY, color) — цвет должен быть в hex-формате
$acetone->fromFile($imageFile)
    ->shadow(50, 15, 15, '#999999')
    ->save($outFile);
```

### Наложение логотипа

[](#наложение-логотипа)

```
// Наложить логотип из файла с «сырыми» опциями logo_*
$acetone->fromFile($imageFile)
    ->logoImageFile($logoFile, ['logo_position' => 0, 'logo_size' => 10, 'logo_opacity' => 1])
    ->save($outFile);

// Логотип из бинарной строки
$acetone->fromFile($imageFile)
    ->logoImage($logoBinary)
    ->save($outFile);
```

Поддерживаемые «сырые» опции логотипа: `logo_angle`, `logo_position`, `logo_opacity`, `logo_size`, `logo_padding`, `logo_correct`.

### Удаление объекта

[](#удаление-объекта)

Удаление объекта, заданного маской (белое = удаляемая область).

```
// Fluent-стиль — цвет заливки должен быть в hex-формате
$acetone->fromFile($imageFile)
    ->maskFile($maskFile)
    ->objectBgColor('#ffffff')
    ->saveObject($outFile);

// Маску можно передать и бинарной строкой
$acetone->fromFile($imageFile)
    ->mask(file_get_contents($maskFile))
    ->getObject('png');

// One-shot стиль (принимает бинарные строки)
$result = $acetone->objectRemove(
    file_get_contents($imageFile),
    file_get_contents($maskFile)
);
```

### Улучшение изображения

[](#улучшение-изображения)

Улучшение/апскейл изображения. Опционально можно передать целевое изображение, к которому подтягивать результат.

```
// Fluent-стиль
$acetone->fromFile($imageFile)
    ->enhanceMode('solo')
    ->saveEnhanced($outFile);

// С целевым изображением (из файла или бинарной строки)
$acetone->fromFile($imageFile)
    ->targetImageFile($targetFile)
    ->saveEnhanced($outFile);

// One-shot стиль
$result = $acetone->enhanceImage(file_get_contents($imageFile));

// Получить результат бинарной строкой
$imageStr = $acetone->fromFile($imageFile)->getEnhanced('png');
```

### Результат в виде бинарной строки

[](#результат-в-виде-бинарной-строки)

```
// Можно указать формат вывода — png, jpg или webp (по умолчанию png)
$imageStr = $acetone->fromFile($imageFile)->get('webp');
$im = imagecreatefromstring($imageStr);
// Какие-то манипуляции
imagejpeg($im, 'image.jpg');
```

### Произвольные опции API

[](#произвольные-опции-api)

Метод `options()` — «escape hatch» для передачи любых «сырых» параметров API, у которых нет отдельного метода. Они мёржатся в query-string запроса.

```
$acetone->fromFile($imageFile)
    ->options(['some_api_param' => 'value'])
    ->save($outFile);
```

### Время запроса

[](#время-запроса)

`getTime()` возвращает время выполнения (в секундах) последнего вызова API.

```
$acetone->fromFile($imageFile)->save($outFile);
echo $acetone->getTime(); // например, 1.234
```

One-shot методы
---------------

[](#one-shot-методы)

Принимают исходное изображение (и, где нужно, дополнительное изображение/маску) как **бинарные строки** и возвращают результат бинарной строкой:

```
$src = file_get_contents($imageFile);

$acetone->backgroundRemove($src);
$acetone->backgroundColor($src, '#ff0000');
$acetone->backgroundGradient($src, ['f00', '33c'], -30);        // линейный, угол вектора
$acetone->backgroundRadialGradient($src, ['f00', '33c'], [120, 240]); // радиальный, центр
$acetone->backgroundBlur($src, 20);
$acetone->backgroundGrayscale($src);
$acetone->backgroundImage($src, file_get_contents($bgFile));
$acetone->backgroundReplace($src, file_get_contents($bgFile));  // псевдоним backgroundImage
$acetone->objectRemove($src, file_get_contents($maskFile));
$acetone->enhanceImage($src);
```

Каждый one-shot метод дополнительно принимает завершающий массив `$options`, который передаётся в `options()`.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance94

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~361 days

Total

4

Last Release

29d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/bdb51a3c707497a4cc826ec61af31a3f33f2a372d8245e1d17a51be913d1c916?d=identicon)[avadim](/maintainers/avadim)

---

Top Contributors

[![aVadim483](https://avatars.githubusercontent.com/u/2246758?v=4)](https://github.com/aVadim483 "aVadim483 (8 commits)")

---

Tags

phpapiimageaibackgroundphotoremovebgtransparent

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/acetonesoft-acetone-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/acetonesoft-acetone-api-php/health.svg)](https://phpackages.com/packages/acetonesoft-acetone-api-php)
```

###  Alternatives

[mtownsend/remove-bg

A PHP package to interface with the remove.bg api.

186467.3k](/packages/mtownsend-remove-bg)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[theodo-group/llphant

LLPhant is a library to help you build Generative AI applications.

1.7k441.1k8](/packages/theodo-group-llphant)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[resend/resend-php

Resend PHP library.

608.3M53](/packages/resend-resend-php)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

563.6M16](/packages/checkout-checkout-sdk-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)