Logo

商品からモデルへ

平置きまたはゴーストマネキンで撮影された商品画像を、プロフェッショナルなオンモデル写真に変換します。

商品からモデルへ

Product to Model エンドポイントは、平置きまたはゴーストマネキンで撮影された商品画像を、プロフェッショナルなオンモデル写真に変換し、モデルの外観や写真スタイルを指定できます。

モデル名: product-to-model

ライフサイクル: stable

処理時間: 約10秒～30秒（スタイルまたはモデル参照を使用すると増加します）

出力形式: Auto (JPEG or 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": "product-to-model",
           "inputs": {
             "productImage": "https://example.com/ghost-mannequin-shirt.jpg",
             "styleId": "editorial",
             "customPrompt": "Asian female model, outdoor city street, natural lighting",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "3:4"
           }
         }'

レスポンス

画像生成には最大20秒かかる場合があるため、/v1/run エンドポイントは非同期ジョブ id とともに 201 Created ステータスを即座に返します。最終結果を取得するには、GET /v1/status/{id} を使用してステータスAPIをポーリングする必要があります。または、Webフックを設定して通知を自動的に受信することもできます。当社のWebフックディスパッチャーは厳格な15秒のタイムアウトを適用することにご注意ください。サーバーは15秒以内に 2xx ステータスコードでWebフックを承認する必要があります。そうしないと、失敗と見なされ、後で再試行されます。

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

status が "succeeded" に変わると、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/product-model-123.png"
  ]
}

リクエストパラメータ

必須パラメータ

productImageRequiredstring

モデルに着用させる商品画像（平置きまたはゴーストマネキン）。公開URLまたはBase64エンコードされた画像文字列を指定できます。最大サイズ：25MB。

プロのヒント: 白い背景の平置き写真は、最も一貫したオンモデル結果を生成します。マネキン写真も同様に機能します。撮影前に、タグ、値札、または衣服の一部ではないアクセサリーを取り除いてください。衣服全体が見えており、広げられていることを確認してください。袖が途切れていないようにしてください。

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

オプションパラメータ

customPromptstring

希望するモデル（例：性別、民族、ポーズ）またはシーンを記述するテキスト指示。最大長：500文字。

modelImageUrlstring

生成に使用する人間の参照モデルのURL。 省略した場合、ランダムな多様なモデルが生成されます。

利用可能なプリセットモデル:

注：参照モデルを提供すると、全体の処理時間が増加します。

styleIdstring

適用する写真スタイルID（例："studio"、"iphone"、"editorial"）。 省略した場合、ニュートラルなスタジオプレゼンテーションがデフォルトとなります。

利用可能なスタイル:

Style NameStyle ID (`styleId`)

注：複雑なスタイルは生成時間を増加させる可能性があります。

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

出力解像度ティア。1k は約1メガピクセル、2k は約4メガピクセル、4k は約16メガピクセルの出力を生成します。 デフォルト: 1k

sampleCountinteger

リクエストごとに生成する画像バリエーションの数。1から4の間である必要があります。 デフォルト: 1

ratiostring

生成される画像の幅と高さの比率を定義します。空の場合、システムはファッションショット用に 3:4 をデフォルトとします。

サポートされている値: '1:1'、'3:4'、'4:3'、'9:16'、'16:9'、'2:3'、'3:2'、'4:5'、'5:4'、'21:9'。

ランタイムエラー

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

クレジットコスト

開発者APIリクエストの場合、コストは選択された出力 quality ティアに sampleCount を乗じたものによって決まります。

計算式: コスト = 品質クレジット × sampleCount

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