使用文本描述一套新服装，将其无缝地穿戴到AI时尚模特身上。

提示词试穿

提示词试穿端点允许您使用文本描述一套新服装，并将其无缝地穿戴到AI时尚模特身上。

模型名称: prompt-tryon

生命周期: stable

处理时间: 约15秒–40秒（使用样式或模型参考时会增加）

输出格式: 自动 (JPEG 或 PNG)

交付方式: URL

积分: 每次生成1到5个（取决于质量）

请求

将您的试穿配置提交到通用 /v1/run 端点：

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

请求示例

认证您可以将API密钥作为Bearer令牌（Authorization: Bearer YOUR_API_KEY）或通过x-api-key头部（x-api-key: YOUR_API_KEY）传递。

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "prompt-tryon",
           "inputs": {
             "personImage": "https://example.com/person.jpg",
             "prompt": "A stylish red summer dress with floral patterns.",
             "quality": "2k",
             "sampleCount": 1,
             "ratio": "16:9",
             "modelImageUrl": "https://example.com/model-reference.jpg",
             "styleId": "movie"
           }
         }'

响应

试穿生成在后台异步进行。您的请求将立即返回 200 OK 状态和一个跟踪对象。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-17T11:00:00Z",
  "error": null,
  "output": null
}

轮询结果 您必须使用返回的 id 轮询状态端点（GET https://fititon.app/api/v1/status/{id}）以检索您生成的图像URL。有关详细说明，请参阅 API 设置指南。

当生成完成时，轮询端点将返回 status: "success"，其中包含最终图像URL的 output 数组：

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://pub-r2.com/.../result-0.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00Z",
  "updated_at": "2026-07-17T11:00:45Z"
}

请求参数

必填参数

personImageRequiredstring

您想要穿戴模型的底图。可以是公开可访问的URL或Base64编码的图像字符串。支持的格式：JPEG、PNG、WEBP。最大尺寸：25MB。

专业提示： 正面姿势且手臂可见的图像能产生最逼真的穿戴效果。

格式要求 提交Base64字符串时，必须包含标准数据URI前缀（例如，data:image/jpeg;base64,...）。/v1/run 端点只接受JSON负载。

promptRequiredstring

您希望模型穿戴的服装的文本描述。

专业提示： 包含面料类型（丝绸、棉、牛仔布）和版型风格（修身、宽松）以获得最佳效果。精确指定颜色（“海军蓝”比“蓝色”效果更好），并明确提及模型已经穿戴的衣物，以便AI确切知道要改变什么。

可选参数

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

提示词试穿（Gemini模型）的输出分辨率等级。分辨率越高，消耗的积分越多。 默认值：1k

sampleCountinteger

每次请求生成的图像变体数量。必须介于1到4之间。额外的图像会消耗更多积分并线性增加处理时间。 默认值：1

ratiostring

定义生成图像的宽高比。如果为空，系统将默认为 personImage 的宽高比。

支持的值：'1:1'、'3:4'、'4:3'、'9:16'、'16:9'、'2:3'、'3:2'、'4:5'、'5:4'、'21:9'。

modelImageUrlstring

可选。用于代替保留原始人物特征的人体参考模型URL。

可用预设模型：

styleIdstring

可选。对输出图像应用特定的摄影风格。

可用风格：

Style Name	Style ID (`styleId`)

有效值：y2k、studio、iphone、professional、lifestyle、analog、streetwear、flash、movie、minimalist、ugc、editorial。

注意：复杂的风格可能会增加整体生成时间。

运行时错误

此功能的运行时错误使用错误处理中记录的共享集。如果在处理过程中发生错误，status 将更新为 "error"，并且 error 字段将包含具体的失败原因。

积分成本

成本取决于所选的 quality 等级，并乘以您的 sampleCount。

公式：成本 = 质量积分 × sampleCount

参数	每张图像积分
`quality="1k"`	1
`quality="2k"`	3
`quality="4k"`	5