使用参考图像或描述性文本提示，将时尚模特重新摆放成精确的姿态。

姿态控制

姿态控制端点允许您获取现有模特图像，并生成模特呈现不同身体姿态的新变体。AI 会精细地保留模特的五官、服装和背景。

模型名称: pose-control

生命周期: stable

处理时间: ~15秒–30秒

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

交付方式: URL

积分: 每个生成的姿态 1 到 5 个积分 (1k: 1, 2k: 3, 4k: 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": "pose-control",
           "inputs": {
             "modelImage": "https://example.com/model-standing.jpg",
             "quality": "2k",
             "poses": [
               {
                 "type": "template",
                 "cdnUrl": "https://example.com/pose-reference.jpg",
                 "title": "Hands on hips"
               },
               {
                 "type": "custom",
                 "text": "Sitting on a chair with legs crossed"
               }
             ]
           }
         }'

响应

由于生成可能需要长达 30 秒，/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 数组。图像的返回顺序与您初始请求中提供的 poses 数组的顺序完全相同：

{
  "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/fititon-pose-123-0.png",
    "https://cdn.fititon.app/users/123/results/fititon-pose-123-1.png"
  ]
}

请求参数

必填参数

modelImageRequiredstring

您希望重新摆放姿态的人的源图像。可以是公开可访问的 URL 或 Base64 编码的图像字符串。

专业提示： 从头到脚的全身照片能产生最佳效果——AI 需要看到整个身体才能正确地重新摆放姿态。紧身衣物比宽松或多层服装更能展现身体结构。简洁、无杂乱的背景让 AI 能够清晰地专注于身体形状。

格式要求 提交 Base64 字符串时，必须包含标准数据 URI 前缀（例如，data:image/jpeg;base64,...）。

posesRequiredarray of objects

定义您要生成的姿态的数组。您可以在同一请求中混合使用模板姿态和自定义姿态。

模板姿态：使用图像作为结构参考。您可以提供任何有效的图像 URL 作为参考姿态，或者使用我们下面列出的官方支持模板之一。
- type (string): 必须是 "template"。
- cdnUrl (string): 演示所需姿态的参考图像 URL。
- title (string, optional): 描述性标签。
自定义姿态：使用文本提示来定义姿态。
- type (string): 必须是 "custom"。
- text (string): 描述新姿态的文本（例如，"standing with arms crossed"）。

官方姿态模板

虽然您可以通过 cdnUrl 提供自己的参考图像，但我们提供了一个精选的、高度优化的姿态模板目录。点击下面的任何 URL 即可预览姿态。

Female Poses

Title	Template URL (`cdnUrl`)

Male Poses

Title	Template URL (`cdnUrl`)

可选参数

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

输出分辨率等级。 默认值：1k

ratiostring

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

支持的值： '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 等级。

公式： 成本 = 质量积分 × 姿态数量

质量等级	每个姿态的积分
1k (默认)	1
2k	3
4k	5

示例：请求 3 个 1k 质量的姿态数组总共花费 3 个积分。请求相同的 3 个 4k 质量的姿态总共花费 15 个积分。