Миграция на Pixian.AI

Получить ключ API

Чтобы помочь вам мигрировать на Pixian.AI, мы внедрили некоторые конечные точки API, совместимые с устаревшими службами. Если вы в настоящее время используете одну из этих служб, миграция на Pixian.AI может быть такой же простой, как изменение конечной точки и ключа API.

remove.bg POST
https://api.pixian.ai/v1.0/removebg

Конечная точка для облегчения миграции с Remove.bg. Мы поддерживаем основные параметры их API. Неподдерживаемые или частично поддерживаемые параметры указаны ниже.

Если вы используете только поддерживаемые параметры, то миграция должна быть такой же простой, как изменение URL-адреса конечной точки и ключа API: 

# Install "remove_bg" first (https://github.com/remove-bg/ruby)
require "remove_bg"

RemoveBg::Api::URL = "https://api.pixian.ai"  # <-- Change the endpoint

RemoveBg.from_file("example.jpeg",
  # Use Pixian.AI API Key:
  api_key: "INSERT_API_KEY_HERE"
).save("pixian_result.png")

Параметры

Входное изображение должно иметь быть представлено одним из следующих вариантов:


Двоичный

Двоичный файл.


Строка

Строка в кодировке base64. Строка может иметь размер не более 1 мегабайта.


Строка

URL-адрес изображения.

Должно быть файлом в формате .bmp, .gif, .jpeg, .png или .tiff.

Максимальный размер загружаемого изображения (= ширина × высота) составляет 32 000 000 пикселей, что сокращается до 25 000 000 пикселей. Перед загрузкой предварительно уменьшите свои изображения до последнего или меньшего размера.


Перечисление, по умолчанию: auto

Поддерживается.

auto интерпретируется как full. Остальные без изменений.


Перечисление, по умолчанию: auto

Поддерживается.

Мы также поддерживаем полное разрешение для вывода png, поэтому вам не придется прибегать к zip для больших изображений.

Файл color.jpeg в наших выходных данных zip имеет черный цвет там, где альфа равна нулю, вместо того, чтобы копировать исходные пиксели.


Логический 		Поддерживается.

Поддерживается.

Перечисление, по умолчанию: rgba 		Поддерживается.

Поддерживается.

Логическое значение, по умолчанию: false

Передайте true, чтобы указать, что это тестовое изображение.

Пропустите код или передайте false для рабочих изображений.

Тестовые изображения можно обрабатывать бесплатно, но на результате будет внедренный водяной знак.

Параметр, характерный для Pixian, может быть недоступен в SDK.

Заголовки результатов
X-Type Мы всегда возвращаем other
X-Width, X-Height Поддерживается и возвращается.
X-Max-Width, X-Max-Height Поддерживается и возвращается, когда входное изображение было сжато перед обработкой.
X-Credits-Charged Фактически начисленные кредиты.
X-Credits-Calculated Рассчитанные кредиты, которые были бы начислены, если бы это был производственный запрос. Возвращается только для тестовых запросов.
X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height Поддерживается и возвращается.
X-Vcs-Ref Не поддерживается и не возвращается.
X-Build-Date Не поддерживается и не возвращается.
X-Version Не поддерживается и не возвращается.
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Возвращается, но не полностью поддерживается.

Если скорость вашего интернета не регулируется провайдером, мы возвращаем 500, 400 и [now].

Если скорость вашего интернета регулируется провайдером, мы возвращаем 500, 0 и [15 seconds from now].

В Pixian.AI не применяется жесткое ограничение скорости — у нас другая философия и подход. См. обсуждение на нашей странице документации по API

Retry-After Возвращается, но работает на основе другой эвристики.

Неподдерживаемые параметры
type, type_level Пропускается. Мы всегда возвращаем X-Type=other
roi Пропускается.
scale Пропускается.
position Пропускается.
add_shadows Пропускается.
semitransparency Пропускается.
bg_image_url Пропускается.
bg_image_file Пропускается.

Нужен один из неподдерживаемых в настоящее время параметров? Пошлите нам сообщение по электронной почте

Получить ключ API