API 设置

要与 Fit-it-on 开发者 API 交互，您必须使用安全的开发者 API 密钥对您的请求进行认证。

生成 API 密钥

登录您的 Fit-it-on 控制面板。
在左侧边栏中导航到 开发者 > API 密钥。
点击 生成新密钥 按钮。
复制您的新密钥（它将始终以 fio_sk_... 开头）。

请妥善保管此密钥！ 出于安全考虑，关闭生成对话框后，您将无法再次查看此密钥。如果您丢失了它，您必须撤销它并生成一个新的。

认证

所有 API 请求都必须在 Authorization 头部中包含您的 API 密钥作为 Bearer 令牌。

curl https://fititon.app/api/v1/run \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "tryon",
    "inputs": { ... }
  }'

异步工作流

Fit-it-on 生成端点（例如 /v1/run）以异步方式运行。这意味着您的初始请求将立即返回一个作业跟踪 ID，而不是等待生成完成。

步骤 1：提交作业

向 https://fititon.app/api/v1/run 发送 POST 请求以排队生成作业。您将立即收到响应：

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

2：轮询结果

使用返回的 id 通过向 https://fititon.app/api/v1/status/{id} 发送 GET 请求来定期检查生成状态。

curl https://fititon.app/api/v1/status/123a87r9-4129-4bb3-be18-9c9fb5bd7fc1 \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

响应将指示您作业的当前状态。当 status 为 "completed" 时，output 字段将包含生成的图像或视频的 URL。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "completed",
  "output": [
    "https://cdn.fititon.app/users/123/results/result-123.png"
  ],
  "error": null,
  "created_at": "2026-07-17T11:00:00.000Z",
  "updated_at": "2026-07-17T11:00:25.000Z"
}

发出您的第一个请求

您可以通过获取当前剩余的开发者积分并检查您的计划来测试您的密钥：

curl https://fititon.app/api/v1/credits \
  -H "Authorization: Bearer fio_sk_YOUR_SECRET_KEY"

如果成功，这将返回一个 JSON 对象，其中包含您当前的计划和剩余积分。