角度生成

角度生成端点允许您获取现有图像并重新定位虚拟相机，以生成新的视角（例如，正面、背面、侧面轮廓），同时保留模型、服装、纹理和光照。

模型名称: angle-generation

生命周期: stable

处理时间: ~10秒–20秒

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

交付方式: URL, Base64 (预览)

积分: 每个生成的角度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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

响应

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

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

请求参数

必填参数

imageUrlRequiredstring

要旋转的源图像。可以是公开可访问的URL或Base64编码的图像字符串。

专业提示： 正面照片能产生最一致的多角度结果。避免倾斜或侧面拍摄的源图像——正面视图能为AI提供最多的信息，而倾斜拍摄会迫使AI虚构缺失的结构细节。

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

angleIdsRequiredarray of strings

您希望生成的角度标识符数组。可用选项包括：

"front": 正面视图
"back": 背面视图
"leftSide": 左侧 (90°)
"rightSide": 右侧 (90°)
"left45": 左45°
"right45": 右45°

可选参数

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

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

ratiostring

宽高比覆盖（例如，16:9，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 等级。

公式： 费用 = 质量积分 × 角度数量

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

示例：以 1k 质量请求 ["back", "leftSide", "rightSide"] 总共花费3个积分。以 4k 质量请求相同的3个角度总共花费15个积分。