Logo

产品上模特

将平铺或幽灵模特产品照片转换为专业的模特上身摄影。

产品上模特

产品上模特端点将平铺或幽灵模特产品照片转换为专业的模特上身摄影，允许您指定模特的形象或摄影风格。

模型名称： product-to-model

生命周期： stable

处理时间： ~10s–30s (使用风格或模特参考时会增加)

输出格式： Auto (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": "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 端点会立即返回 201 Created 状态以及一个异步作业 id。您必须使用 GET /v1/status/{id} 轮询状态 API 以检索最终结果。或者，您可以配置 Webhook 以自动接收通知。请注意，我们的 Webhook 调度程序强制执行严格的 15秒超时。您的服务器必须在15秒内以 2xx 状态码确认 Webhook，否则我们将认为其失败并稍后重试。

{
  "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。

公式：Cost = QualityCredits × sampleCount

质量等级每张图片积分
1k (默认)1
2k3
4k5