Logo

背景の置き換え

被写体を分離し、完全に新しいリアルな背景を生成します。

背景の置き換え

背景置き換えエンドポイントを使用すると、画像から被写体を分離し、テキストプロンプトに基づいて完全に新しいリアルな背景を生成できます。

モデル名: background-replace

ライフサイクル: stable

処理時間: 約5秒～15秒

出力形式: 自動 (JPEGまたはPNG)

配信方法: URL

クレジット: 生成ごとに1～5 (品質による)

リクエスト

背景置き換えの設定をユニバーサルな /v1/run エンドポイントに送信します。

POSThttps://fititon.app/api/v1/run

リクエスト例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "background-replace",
           "inputs": {
             "subjectImage": "https://example.com/product.jpg",
             "scenePrompt": "Product sitting on a sandy beach during golden hour",
             "quality": "2k"
           }
         }'

レスポンス

初期のトラッキングオブジェクトとともに 201 Created ステータスを返します。生成は非同期で実行されます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

status が "succeeded" に変更されると (GETエンドポイントをポーリングすることで)、output フィールドには生成された背景を指すURLを含む配列が含まれます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/bg-replace-123.png"
  ]
}

リクエストパラメータ

必須パラメータ

subjectImageRequiredstring

分離したい被写体を含む画像。公開されているURLまたはBase64エンコードされた画像文字列を指定できます。最大サイズ：25MB。

プロのヒント: コントラストのある背景に対して明確でシャープなエッジを持つ被写体は、最もきれいな切り抜きが得られます。被写体が背景に溶け込んでいる画像（例：白い壁に白いシャツ）は避けてください。高コントラストの照明は、AIがエッジ検出に頼って被写体を完璧に分離するのに役立ちます。

フォーマット要件 Base64文字列を送信する場合、標準のデータURIプレフィックス（例：data:image/jpeg;base64,...）を含める必要があります。

scenePromptRequiredstring

被写体の背後に生成したい新しい背景シーンのテキストによる説明。

オプションパラメータ

quality'1k' | '2k' | '4k'

出力解像度ティア。最終的に生成される画像の解像度を定義します。 デフォルト: 1k

ランタイムエラー

この機能のランタイムエラーは、エラー処理に記載されている共通のセットを使用します。処理中にエラーが発生した場合、status は "error" に更新され、error フィールドには具体的な失敗理由が含まれます。

クレジットコスト

開発者APIリクエストの場合、コストは選択された出力 quality ティアに完全に依存します。

計算式: コスト = QualityCredits

品質ティア画像あたりのクレジット
1k (デフォルト)1
2k3
4k5