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 する必要はありません。

zip 出力における color.jpeg ファイルには、元のピクセルを再現する代わりにアルファがゼロの黒が含まれます。


ブーリアン
対応。

対応。

列挙型、デフォルト:rgba
対応。

対応。

ブール型、デフォルト:false

これが試験用画像であることを示すため、trueを渡します。

実際の画像向けには、省略するか、falseを渡してください。

試験画像は、自由に処理できますが、結果にはウォーターマークが組み込まれます。

SDK では、Pixian 固有のパラメータが利用できない可能性があります。

結果ヘッダー

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

返されますが、完全対応ではありません。

絞っていない場合、500400、および [now] が返されます。

絞っている場合、5000、および [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 キーを取得