API 基础

Fit-it-on 开发者 API 提供对我们 AI 生成模型的程序化访问。它遵循标准的 REST 架构风格，使用可预测的面向资源的 URL，并接受 JSON 编码的请求体。

异步执行

所有图像生成都以异步方式处理。高分辨率 AI 渲染（2k 或 2048x2048 样本）需要时间，同步连接将不可避免地超时。

1. 提交任务：您发送一个 POST /v1/run 请求，其中包含您的输入数据。
2. 接收 ID：API 立即返回 200 OK 和一个 prediction_id。
3. 轮询状态：您定期调用 GET /v1/status/{predictionId}。
4. 完成：当状态转换为 succeeded 时，您生成的图像的 URL 将在 output 数组中可用。

基础 URL

所有请求都必须通过 HTTPS 发送到我们的生产环境：

https://fititon.app/api

内容类型

所有 POST 和 PATCH 请求都必须包含以下标头以指定负载格式：

Content-Type: application/json

API 也严格以 JSON 格式返回所有响应。

Webhook

如果您在 JSON 负载的根部提供 webhook_url，一旦异步任务完成（无论是成功还是出错），我们将立即向该 URL 发送一个 HTTP POST 请求。

Webhook 负载示例：

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "success",
  "output": [
    "https://storage.fititon.com/results/result-123.jpg",
    "https://storage.fititon.com/results/result-124.jpg"
  ],
  "error": null,
  "created_at": "2026-07-03T10:00:00.000Z",
  "updated_at": "2026-07-03T10:00:15.000Z"
}

请求限制与处理

为防止滥用，API 根据您当前的开发者计划等级强制执行速率限制。

如果您超出限制，将收到 429 Too Many Requests 错误。您的应用程序应通过实现指数退避来优雅地处理此情况。