はじめに
image_url を送ると、写真 1 枚から透過 PNG の切り抜きを取得できます。この処理には prompt、mask、quality のフィールドは公開されていません。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| モデル識別子 | ideogram/remove-background |
| リクエストごとの入力 | 写真 1 枚です。 |
| 公開パラメータ |
|
| テキストによる指示 | prompt パラメータはありません。 |
| 写真ごとの出力 | 切り抜き画像 1 枚です。 |
| 出力の形式 | PNG |
| 背景の状態 | 透明です。 |
| 課金の基準 | 完成した画像 1 枚ごとの固定料金です。 |
| 失敗したリクエスト | 課金対象になりません。 |
| 結果の保存期間 | 14 日間保存後に削除されます。 |
主な機能とハイライト
ベル本体だけでなくレバーも確認
真ちゅう製自転車ベルの検証では、周囲の作業台から部品を切り離せました。透過 PNG にレバーとクランプの縁が残り、確認すべき小さな輪郭の具体例になっています。掲載結果でこのテストの内容を把握し、ご自身の商品写真でも対応する細部を確認してからカタログを組んでください。
URL 1 つで切り抜きを開始
文章による指示やマスクを準備せず、元写真を image_url で送ります。完成画像は 1 枚ごとの固定料金で、透過 PNG が返ります。プールサイドのカバーは変化を表したイラストで、このエンドポイントの生成サンプルではありません。実測結果はベルと赤いサテンの例で確認できます。
赤いサテンの輪郭を確認
肩ひものない赤いサテンドレス姿の女性のスタジオ写真が、透過 PNG になりました。この結果では髪と裾の境界がきれいでした。掲載例を確認したうえで、ご自身のポートレートも対照的な背景に重ねて点検してください。このスタジオ写真の切り抜きで確認した結果であり、すべての髪型、衣服、場所について約束するものではありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 背景を取り除く元写真の URL を指定します。必須入力で既定値はありません。 1 文字以上 |
料金
$0.012 / 枚
Ideogram の背景除去では、切り抜きが完了した画像に固定料金がかかります。処理に失敗した場合は課金されません。
ユースケース
小さな部品のカタログ制作
商品写真をカタログの構成素材にできます。真ちゅう製自転車ベルの例ではレバーとクランプの縁が残っており、類似の小物でも確認すべき細部が分かります。
ファッションのポートレート配置
撮影した衣服と着用者をスタジオ背景から切り離せます。赤いサテンのポートレートでは髪と裾の境界がきれいに返り、配置前に確認できました。
プロフィールや登壇者の画像
使用許可のある人物写真を選び、透過ポートレートをプロフィールや登壇者紹介のレイヤーとして使います。名前と背景はデザイン編集ソフトで追加してください。
キャンペーン背景の展開
保存した PNG を異なるキャンペーンカラーや画像に重ねて再利用できます。背景の配置はレイアウト工程で行い、各完成版と一緒に透過素材も保管します。
プロンプトガイドと実践のヒント
元写真を選びます
独立した素材として使いたい被写体の写真を選びます。人物の場合は使用権のある成人の写真を用い、なりすましを避けます。
画像の URL を送ります
image_urlで写真を指定します。文章の説明は別の場所で元写真を準備する際には役立ちますが、このエンドポイントに prompt や mask は送りません。返された PNG を点検します
編集ソフトで明るい背景と暗い背景に重ね、髪、衣服の裾、小さな部品などの細い輪郭を確認してから配置します。
切り抜きを保存して配置します
14 日間の保存期間内に PNG を保存します。別の合成工程で背景を加え、再利用用の透過画像も残してください。
写真を繰り返し使える切り抜き素材に
Ideogram Remove Background は写真の被写体を周囲から切り離し、透過 PNG を 1 枚返します。既存の写真からカタログ、ポートレートのレイアウト、キャンペーンの構成素材を作る場合に、この image-edit エンドポイントを使います。入力は image_url で、解釈させる文章の指示はありません。
切り抜ける内容は元写真で決まります。別の場所に配置したい人物や商品が写った写真を選び、送信前に見えている輪郭を確認します。人物写真は使用権のある成人のものを使い、なりすましをしないでください。
リクエストのパラメータ
| パラメータ | 必須入力 | 役割 |
|---|---|---|
image_url | 元写真 1 枚の URL | 背景除去する写真を渡します |
公開パラメータには prompt、mask、quality、出力形式、解像度の選択はありません。画像生成の例から設定を流用して、この処理を調整できるとは考えないでください。出力は透過 PNG と定められているため、文章で透明化を依頼する必要もありません。
赤いサテンの例では、image_url にスタジオ写真を指定しました。ドレス、髪型、背景を文章で説明したわけではなく、それらは元写真に写っていたものです。
料金と結果の保存
背景除去が完了した画像 1 枚ごとの固定料金で、失敗したリクエストは無料です。送信前に Ideogram Remove Background のモデルページ で現在の料金を確認してください。他の画像ツールの価格やサブスクリプションの案内では、このエンドポイントの単価は分かりません。
返された PNG は 14 日以内にダウンロードします。期間が過ぎると結果は削除されます。後のレイアウト変更でホスト先のファイルに依存しないよう、切り抜きと元写真をまとめて保管してください。
元写真の説明例の使い方
背景除去のリクエストにプロンプトは不要です。このページのプロンプト例は、別の場所で元写真を選ぶ、撮る、準備するための説明です。服装、雰囲気、照明、場所を決める際に使い、写真ができたら画像 URL を送ります。
たとえばサテンのイブニングドレスを着た 30 代の女性という説明は、スタジオ写真の準備に使えます。それを切り抜きのリクエストに加えても、対応する操作にはなりません。同様に商品撮影の説明では、撮る前に真ちゅうの仕上げ、角度、作業場の柔らかい光を指定できます。
入力を用意する際は、次を確認します。
- 構成に必要な部分が写真内に見えているようにします。
- 人物、商品、名前で指定する特定の物体のどれが必要かを決めてから処理を選びます。
- 人物写真は使用許可を確かめ、成人を対象にします。
- 細部を切り抜きと比較できるよう元写真を残します。
サンプルで実際に確認したこと
真ちゅう製自転車ベル
金属部品のテストでは、真ちゅう製自転車ベルをきれいに分離できました。周囲の作業台を取り除いても、レバーとクランプの縁は残りました。ベル全体の形だけでなく、こうした小さな部品も元写真と比較してください。
赤いサテンのスタジオポートレート
赤いサテンの例は、肩ひものないドレスを着た女性のスタジオ写真を使いました。髪と裾がきれいな輪郭の透過 PNG として返りました。これはその写真についての観察で、どんな髪型、布、背景でも同じ結果になることを示してはいません。
プールサイドのカバーはイラストで、生成サンプルや別の実測結果ではありません。ここで説明する結果の根拠は、2 つの切り抜き例です。
配置する前に PNG を確認
透明を表示できる編集ソフトでダウンロードファイルを開きます。明るい背景と暗い背景に重ね、実際に使う大きさで髪、衣服の裾、細い部品の輪郭を確認してください。プレビューの市松模様は表示補助です。レイアウトに合うかは PNG 自体を見て判断します。
透過画像には、新しい白背景や別のシーンは含まれません。必要な背景は合成ツールで加え、完成版と一緒に透過素材も残します。同じ素材を異なる配置に使えますが、背景の置き換えはこのエンドポイントの設定ではありません。
切り抜きの制約と関連モデル
1 回のリクエストで写真 1 枚を処理し、透過 PNG を 1 枚返します。対象物を名指ししたり、服装、照明、周囲の変更を依頼したりする公開テキスト欄はありません。そうした点を決めたうえで元画像を選んでください。
背景除去には Background Remover V1 もあります。文章で特定の物体を選びたい場合は Object Extractor V1 を使ってください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/remove-background/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。





