角度生成

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

模型名称: angle-generation

生命周期: stable

处理时间: ~10s–20s

输出格式: Auto (JPEG or 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 个积分。