生成完全独特的AI时尚模型，或上传自定义参考图像用于试穿。

模型创建

模型创建使您能够通过简单直观的提示或参考图像生成逼真的时尚模型，或将现有模型图像上传到您的工作区。

模型名称: model-create

生命周期: stable

处理时间: 约10秒–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": "model-create",
           "inputs": {
             "type": "generate",
             "name": "Summer Collection Model",
             "prompt": "Full body shot, woman wearing a white t-shirt and dark blue biker shorts, studio lighting",
             "gender": "female",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

响应

由于模型生成可能需要长达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：

{
  "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/model-123.png"
  ]
}

请求参数

必填参数

typeRequired'generate' | 'upload'

指定是通过AI生成新模型 (generate) 还是上传现有图像 (upload)。

nameRequiredstring

模型的描述性名称。用于在您的工作室中识别模型。

promptstring

生成时必填要生成的模型的文本描述。描述所需的时尚模型、服装、姿势和背景场景。

专业提示： 如果您使用 faceModelId 等参考，AI将优先考虑参考的身份，但会使用您的提示来确定设置、服装和身体特征。仅当提供了 faceModelId 时才可选。

imageBase64string

上传时必填 Base64编码的图像字符串。当 type 设置为 upload 时必填。

格式要求 您的Base64字符串必须包含标准数据URI前缀（例如，data:image/jpeg;base64,... 或 data:image/png;base64,...）。如果只提供了原始编码字符串，上传将失败。

可选生成参数

这些参数在 type 设置为 generate 时适用。

genderstring

模型的性别。有助于生成模型确定身体属性。

bodyTypestring

模型的体型（例如，“运动型”、“大码”、“苗条”）。

clothingstring

生成过程中要强制执行的特定服装细节，以增强主要 prompt。

posestring

姿势的文本描述（例如，“站立双手插兜”、“行走”）。

faceModelIdstring

现有面部模型的UUID，用于在不同生成中锁定特定身份。输出将适应目标提示，同时保留参考面部。

注意：提供面部参考会增加总处理时间几秒钟，因为AI需要对齐身份。

poseModelIdstring

现有姿势模型的UUID。强制生成严格匹配身体姿势和体态的参考。

注意：提供姿势参考会增加处理时间。

poseImageBase64string

Base64编码的图像字符串，用作临时姿势参考，而不是提供已保存的 poseModelId。

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

输出分辨率等级。1k 生成约1百万像素的输出，2k 约4百万像素，4k 约16百万像素。更高的分辨率会消耗更多积分。默认: 1k

aspectRatiostring

定义生成图像的宽高比。

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

默认: 3:4

sampleCountinteger

每次请求生成的图像变体数量。额外的图像会消耗更多积分并线性增加处理时间。默认: 1

运行时错误

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

积分成本

对于开发者API请求，成本取决于所选的输出 quality 等级。

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