Migracja do Pixian.AI

Uzyskaj klucz interfejsu API

Aby ułatwić migrację do Pixian.AI, zaimplementowaliśmy wybrane punkty końcowe API zgodne z legacy-service. Jeśli obecnie korzystasz z jednej z tych usług, migracja do Pixian.AI może być tak prosta, jak zmiana punktu końcowego i klucza API.

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

Punkt końcowy ułatwiający migrację z remove.bg. Obsługujemy główne parametry ich API. Nieobsługiwane lub częściowo obsługiwane parametry są wymienione poniżej.

Jeśli używasz tylko obsługiwanych parametrów, migracja powinna być tak prosta, jak zmiana adresu URL punktu końcowego i klucza 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")

Parametry

Obraz wejściowy musi zostać podany jako jeden z poniższych:


Binarny
Opcjonalne

Plik binarny.


Ciąg
Opcjonalne

Ciąg zaszyfrowany algorytmem base64. Rozmiar ciągu nie może przekraczać 1 megabajta.


Ciąg
Opcjonalne

Adres URL do pobrania.

Musi być plikiem.bmp, .gif, .jpeg, .png, .tiff lub .webp.

The maximum image upload size (= width × height) is 32 000 000 pixels, which gets shrunk to 25 000 000 pixels. Przed przekazaniem obrazy należy wstępnie zmniejszyć do rozmiaru mniejszego lub równego wskazanemu powyżej.


Enum, domyślnie: auto

Obsługiwane.

auto jest interpretowany jako full. Reszta pozostaje niezmieniona.


Enum, domyślnie: auto

Obsługiwane.

Obsługujemy również pełną rozdzielczość dla wyjścia png, więc nie musisz uciekać się do zip w przypadku dużych obrazów.

Plik color.jpeg na naszym wyjściu zip ma kolor czarny, gdzie alfa wynosi zero, zamiast replikować oryginalne piksele.


Wartość logiczna
Opcjonalne
Obsługiwane.


Opcjonalne
Obsługiwane.

Enum, domyślnie: rgba
Obsługiwane.


Opcjonalne
Obsługiwane.

Wartość logiczna, domyślnie: false

Przekaż true aby wskazać, że jest to obraz testowy.

W przypadku obrazów produkcyjnych pomiń albo przekaż false.

Obrazy testowe można przetwarzać bezpłatnie, ale rezultat będzie opatrzony znakiem wodnym.

Parametr specyficzny dla Pixana może nie być dostępny w zestawach SDK.

Nagłówki wyników

X-Type Zawsze wracamy other
X-Width, X-Height Wspierane i zwrócone.
X-Max-Width, X-Max-Height Obsługiwane i zwracane, gdy obraz wejściowy został skurczony przed przetworzeniem.
X-Credits-Charged Rzeczywiste naliczone kredyty.
X-Credits-Calculated Obliczone kredyty, które zostałyby naliczone, gdyby było to żądanie produkcji. Zwracane tylko w przypadku próśb testowych.
X-Foreground-Top, X-Foreground-Left, X-Foreground-Width, X-Foreground-Height Wspierane i zwrócone.
X-Vcs-Ref Nie wspierany i nie zwrócony.
X-Build-Date Nie wspierany i nie zwrócony.
X-Version Nie wspierany i nie zwrócony.
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Powrócił, ale nie w pełni wspierany.

Jeśli nie jesteś ograniczony, zwracamy 500, 400 i [now].

Jeśli jesteś ograniczony, zwracamy 500, 0 i [15 seconds from now].

Pixian.AI nie stosuje twardego limitu stawek - mamy inną filozofię i podejście. Zapoznaj się z dyskusją na naszej stronie dokumentacji API

Retry-After Powrócił, ale działa na innej heurystyce.

Nieobsługiwane parametry

type, type_level Ignorowane. Zawsze wracamy X-Type=other
roi Ignorowane.
scale Ignorowane.
position Ignorowane.
add_shadows Ignorowane.
semitransparency Ignorowane.
bg_image_url Ignorowane.
bg_image_file Ignorowane.

Potrzebujesz jednego z obecnie nieobsługiwanych parametrów? Prosimy o przesłanie nam e-maila

Uzyskaj klucz interfejsu API