Codia

Remove BG

概要

Remove BG は画像から背景を除去し、透過 PNG を返します。1つのエンドポイント、1つの必須フィールド、1つのレスポンス形状。商品ページ、デザインツール、広告クリエイティブパイプライン、クリーンな切り抜きを大規模に必要とするあらゆるワークフロー向けに設計されています。

エンドポイント

POSThttps://api.codia.ai/v1/open/remove_bg

認証は Bearer トークンで行います。キーは codia.ai/dashboard/developer で取得してください。

リクエスト

フィールド型必須説明
image_urlstringはい公開アクセス可能なソース画像の URL。

例

bash
curl 'https://api.codia.ai/v1/open/remove_bg' \ -H 'Authorization: Bearer {codia_api_key}' \ -H 'Content-Type: application/json' \ --data '{ "image_url": "your image url" }'

レスポンス

json
{ "code": 0, "message": "ok", "data": { "image_url": "https://processed-image-url.com/result.png" } }
フィールド説明
code成功時は 0。非ゼロ値は入力または処理エラーを示します。
message人間可読なステータス。
data.image_url透過背景の結果 PNG の CDN URL。お客様側でプルして保存してください。URL は長期間有効ではありません。

出力特性

  • フォーマット — アルファチャンネル付き PNG。
  • 解像度 — プランの最大値まで入力に一致（全ティアで HD）。
  • エッジ品質 — サブピクセルマッティング、前景のカラーデコンタミネーション、背景シャドウのスミアなし。
  • 被写体のセルフシャドウ — 保持されます（例：マグカップの裏面の影）。

パフォーマンス

設定値
一般的な処理時間約 600 ms
エンドツーエンドレイテンシ800 〜 1200 ms
並行性プラン依存。一般的なプランでは数百の並列リクエストに対応

対応入力

入力推奨事項
一般的なフォーマットJPEG、PNG、WEBP
最小解像度長辺 400 px
最大サイズプラン依存。デフォルト 25 MB
既存アルファ付き画像意図した透過を保持するには、呼び出す前に白で平坦化
極端なモーションブラー動作するがエッジがソフトになる
被写体/背景のカラー衝突（例：白 on 白）使用可能だが人間レビューを検討

エラーコード

code意味
0成功。
40001image_url が未指定または到達不能。
40002非対応フォーマット。
40003画像がサイズ制限を超過。
42900レート制限超過 — バックオフしてリトライ。
50000一時的なサーバーエラー — バックオフしてリトライ。

非ゼロの code は常に分岐のシグナルとして扱ってください：一時的なエラーではリトライ、入力エラーではフェイルファスト。

統合パターン

商品アップロード（同期）

js
const res = await fetch('https://api.codia.ai/v1/open/remove_bg', { method: 'POST', headers: { 'Authorization': `Bearer ${CODIA_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ image_url: sourceUrl }), }).then((r) => r.json()) if (res.code === 0) { await saveToBucket(res.data.image_url) }

バッチ取り込み（非同期）

大規模カタログの場合、プランの並行性制限でワーカープールを実行し、一時的な障害をリトライしてください。最小解像度を下回る画像は呼び出しを無駄にするよりスキップしてください。

合成確認

開発中は返された PNG を暗い背景（例：#111）に合成し、エッジのフリンジングを確認してください。クリーンな切り抜きは問題なく表示されます。ハロが見える場合は、入力を確認してください。

FAQ

URL の代わりにアップロードできますか？

現在のエンドポイントでは URL が必要です。マルチパートアップロードが必要な場合は [email protected] までご連絡ください — ロードマップに含まれており、エンタープライズプランでは現在利用可能です。

出力 URL は永続的ですか？

いいえ。結果をダウンロードしてお客様のバケットに保存してください — URL は取得に十分な期間有効ですが、期限切れになります。

画像サイズによって料金は変わりますか？

いいえ。料金は成功した呼び出しごとの一律です。

未使用クレジットのロールオーバーはありますか？

はい — 有料プランでは未使用クレジットが月ごとにロールオーバーされます。料金ページ をご覧ください。

キャストシャドウを残すことはできますか？

デフォルトではキャストシャドウを含むすべての背景が除去されます。シャドウの保持は、設定フラグ付きのエンタープライズデプロイメントで利用可能です。

次のステップ