コンテンツへスキップ

Pixelcut Product Photo

統合

モデルID pixelcut/product-photo
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixelcut/product-photo?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエスト: $0.024 24 APIクレジット このページで実行

APIキーを取得
Pixelcut 画像編集 #utility#editing

商品画像コンポジター:商品を切り抜き、背景、余白、影を設定した新しいキャンバスに配置します

Pixelcut · 画像

最初の結果がここに表示されます

以下でリクエストを作成し、APIキーで実行してください。出力はストレージにコピーされ、永久保存または無料で7日保存されます。

リクエストを作成

コントロールはモデルスキーマから生成されます。値を変更するとコードと価格が更新されます。

•必須 image_url
ファイルをドロップ、または

処理対象の商品の画像URL。

image_size デフォルト square_hd

出力キャンバスの寸法。カスタムの{width, height}、またはsquare_hd、square、portrait_4_3、portrait_16_9、landscape_4_3、landscape_16_9のプリセットで指定します。デフォルトはsquare_hd (1024x1024)です。

詳細設定 output_format · background · margin · shadow · watermark
output_format

PNGまたはJPEGから選択する出力画像のエンコード。透明背景ではJPEGを使用できません。選択を省略すると入力の形式が維持されます。

出力の背景。画像、透明、またはデフォルトで白になる単色を指定します。

商品とキャンバス端との間隔。`all`ですべてのマージンを設定し、個別の辺を任意で上書きできます。デフォルトは各辺20%です。

影の設定。'Generative'または'Drop'を選択して設定します。未設定の場合は影を適用しません。

画像を指定するとロゴまたは透かしを重ねます。省略時はデフォルトどおり、透かしなしの出力になります。

POST /run/pixelcut/product-photo?wait=20 見積もり → $0.024
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixelcut/product-photo?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエストを実行

キーはこのブラウザ内に保持されます。Doitong APIにのみ送信され、「記憶する」にチェックを入れた場合のみlocalStorageに保存されます。 APIキーを取得

Pixelcut Product Photoについて

商品写真をカタログ風の画像に加工します。`image_size`プリセットまたはカスタム寸法でキャンバスを設定し、単色、透明、画像の`background`を選択して、`margin`を調整できます。生成影またはドロップシャドウの`shadow`と、任意の`watermark`オーバーレイも使用できます。出力はpngまたはjpegで、jpegは透明背景と併用できません。

パラメータ

正式名称またはネイティブ名のいずれか一方を送信してください。両方は送信しないでください。 正式名称

名前型 デフォルト許可される値 説明
image_url必須 image
型url · image
処理対象の商品の画像URL。
image_size任意
型object
デフォルトsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
出力キャンバスの寸法。カスタムの{width, height}、またはsquare_hd、square、portrait_4_3、portrait_16_9、landscape_4_3、landscape_16_9のプリセットで指定します。デフォルトはsquare_hd (1024x1024)です。
background任意
型object
出力の背景。画像、透明、またはデフォルトで白になる単色を指定します。
background.mode任意
型enum
デフォルトColor
TransparentColorImage
背景モード。'Color'は`color`を使用し、デフォルトは白です。'Transparent'は透明にし、常にPNGを使用します。'Image'は`image_url`上に結果を合成します。
background.color任意
型object
デフォルト{"b":255,"g":255,"r":255}
'Color'モードの単色背景。デフォルトは白で、0~255のR/G/B成分で指定します。
background.color.r必須
型integer
0 – 255
background.color.g必須
型integer
0 – 255
background.color.b必須
型integer
0 – 255
background.image_url任意
型url · image
背景画像のURL。'Image'モードでは必須です。
background.image_fit任意
型enum
デフォルトCover
CoverContainStretch
背景画像をキャンバスに合わせる方法。'Contain'は`color`上にレターボックスを付けて画像全体を収め、'Stretch'は歪ませて合わせ、'Cover'はトリミングしてキャンバスを埋めます。
margin任意
型object
商品とキャンバス端との間隔。`all`ですべてのマージンを設定し、個別の辺を任意で上書きできます。デフォルトは各辺20%です。
margin.all任意
型string
デフォルト20%
全辺の均一なマージン。キャンバス寸法に対する'%'で0~49%、または最小0pxの'px'で指定します。
margin.left任意
型string | null
その辺の`all`を置き換える左マージン。0~49%の'%'、または0px以上の'px'を指定できます。
margin.right任意
型string | null
その辺の`all`を置き換える右マージン。0~49%の'%'、または0px以上の'px'を指定できます。
margin.top任意
型string | null
その辺の`all`を置き換える上マージン。0~49%の'%'、または0px以上の'px'を指定できます。
margin.bottom任意
型string | null
その辺の`all`を置き換える下マージン。0~49%の'%'、または0px以上の'px'を指定できます。
shadow任意
型object
影の設定。'Generative'または'Drop'を選択して設定します。未設定の場合は影を適用しません。
shadow.type任意
型enum
GenerativeDrop
任意の影スタイル。未設定時は影なしです。AI合成には'Generative'、決定論的なドロップシャドウには'Drop'を選択します。
shadow.generative任意
型object
タイプが'Generative'の場合に適用するAI生成影の設定。
shadow.generative.opacity任意
型number
デフォルト0.2
0 – 1
合成後の影の不透明度。0~1の範囲です。
shadow.generative.light_source任意
型object
影の合成に使用する明示的な仮想光源。指定すると、画像から自動推定される光の方向を置き換えます。
shadow.drop任意
型object
タイプが'Drop'の場合に適用するドロップシャドウの設定。
shadow.drop.color任意
型object
デフォルト{"b":0,"g":0,"r":0}
影のRGB色。デフォルトは黒です。
shadow.drop.horizontal任意
型number
デフォルト50
-100 – 100
影の水平方向のずれ。最大値100はキャンバス幅の10%を表します。値は-100~100で、負の値は左、正の値は右へ移動します。
shadow.drop.vertical任意
型number
デフォルト8
-100 – 100
影の垂直方向のずれ。最大値100はキャンバス高さの10%を表します。値は-100~100で、負の値は上、正の値は下へ移動します。
shadow.drop.blur任意
型number
デフォルト24
0 – 100
影のぼかし設定。最大の柔らかさである100は、短い方のキャンバス寸法の5%の半径に相当します。範囲は0から始まり、0ではエッジが硬いままになります。
shadow.drop.opacity任意
型number
デフォルト0.25
0 – 1
影の不透明度。0~1の範囲です。
watermark任意
型object
画像を指定するとロゴまたは透かしを重ねます。省略時はデフォルトどおり、透かしなしの出力になります。
watermark.image_url任意
型url · image
ロゴまたは透かし画像のURL。空の値では透かしなしの出力になります。
watermark.remove_background任意
型boolean
デフォルトfalse
背景除去によって透かしの背景を取り除くかどうか。これによりオーバーレイから背景が除外されます。
watermark.position任意
型enum
デフォルトbottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
透かしの配置。
watermark.scale任意
型number
デフォルト0.1
0.01 – 1
キャンバス幅に対する割合で表す透かしの幅。
watermark.opacity任意
型number
デフォルト1
0 – 1
透かしの不透明度。0~1の範囲です。
watermark.margin任意
型string
デフォルト3%
キャンバス端から内側への距離。キャンバスに対する'%'(0~49%)または'px'で指定します。
output_format任意
型enum
pngjpeg
PNGまたはJPEGから選択する出力画像のエンコード。透明背景ではJPEGを使用できません。選択を省略すると入力の形式が維持されます。
必須 正式名称(こちらも使用可能)

ファイルパラメータには、公開されたhttps:// URL、10 MBまでのdata: URI、またはアップロードしたファイルのfile_urlを指定します。 ファイル

出力

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixelcut/product-photo",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 24,
    "usd": "0.024",
    "charged": 24,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ファイルの保存期間を選択すべてのoutputs[].urlはストレージ上のコピーです。アカウント設定または?storage=により、永久保存(GB・月単位で有料)または無料で7日保存できます。
すべてのモデルで同じ形式画像、動画、音声のいずれでも、type、url、content_type、width、height、durationが含まれます。outputはモデル独自の結果オブジェクトです。
出力フィールド
image
object {url, content_type, file_name, file_size, width, height} | nullカタログ用に準備された商品写真。

その他のモデル: 画像編集

AIエージェント向け:このページのMarkdown版はこちらです: https://doitong.com/ja/developers/models/pixelcut/product-photo.md. すべてのモデルとガイド: https://doitong.com/developers/llms.txt